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INTRODUCTION TO THE TENEX JSYS MANUAL 



This manual defines all of the monitor calls which 
exist in the TENEX System. All of these calls are by means 
of the JSYS instruction, detailed in the Appendix of this 
manual. The UUO type monitor calls (UUO's 40-77) invoke the 
10/50 compatibility program which simulates the action of 
these UUO's in the DEC TOPS-10 monitor. See the 
DECsystem-10 documentation for operation of these calls. 

For the sake of brevity, JSYS definitions have a very 
concise format. This format begins with the JSYS mnemonic 
and numeric definition followed by a brief description of 
the function of the JSYS. Next comes the line 

ACCEPTS IN n: 

which is followed by a list of numeric accumulators and a 
description of what must be in each accumulator. Next 
follows the JSYS mnemonic and then a number of statements of 
the form 

RETURNS +1: 
+2: 
+ 3: 



which define where the JSYS code returns and under what 
conditions. RETURNS +1: means returns to the calling 
location plus 1, +2: means returns to the calling location 
plus 2, etc. Next there is an optional detailed description 
of what the JSYS does. The JSYS definition is ended with an 
optional list of error mnemonics. A JSYS is generally 
transparent to the accumulators unless a explicit mention is 
made of values being returned in specific accumulators. 
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TENEX SOURCE/DESTINATION DESIGNATORS 

Several JSYS's which do such things as I/O Conversion (e.g. 
floating input/output, fixed input/output, directory numbers 
to strings and vice versa, etc.) may expect to read or write 
using strings in core, bytes in files, terminals, etc. In 
order to specify which of the above sources and destinations 
are being used in a single argument, a kind of universal 
argument called the TENEX source/destination designator has 
been specified. It has the formats shown below: 



left 


half 


right half 


meaning 










see below 

100 
101 


a JFN (typically 
<155) octal 
primary input ** 
primary output ** 






4xxxxx 


a specific 
terminal number 






377777 


NIL designator: 



infinite sink of 
output and infinite 
source of zeros 
on input just as a 
JFN for device NIL: 



777777 



the controlling 
terminal 



reasonable left 
half of byte ptr 



effective adr 



a byte pointer to 
the beginning of 
a string 



777777 



effective adr 
(<777777) 



implicit byte 
pointer with left 
half to be 
changed to 440700 



777777 



777777 



universal default 



5xxxxx 
6xxxxx 



XX XX XX 

xxxxxx 



special cases for 
immediate 33 bit 
source number 



* The JFN is the Job File Number which is a job-qlobal 
handle on a file as defined in the introduction of section 
2. 



** These designators are legal wherever a JFN is expected. 
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TENEX FILE DESIGNATOR 

A TENEX file designator is a subset of the TENEX 
source/destination designator. It includes all options 
except string pointers. 



TENEX DEVICE DESIGNATOR 

Many JSYS's dealing with special devices (Section 4) 
take a "TENEX device designator" as an argument. This can 
be either: 

LH: 600000+device type number 

RK: unit number, or -1 for non-units device 

OR: 

LH: 

RH: 4000()0+a terminal number, 

or -1 for controlling terminal 

Terminals can thus be represented in two ways; the latter is 
provided for compatiblity with the TENEX source/destination 
designator. 

The various devices are described and their type 
numbers are given in section 4 of this manual. 



Conventions about Strings and String Pointers 

A convention about passing strings and string pointers 
is used for most JSYS's. Strings are usually designated by 
the byte pointer subset of the source/destination 
designators. A left half of -1 is changed to 440700(8) to 
point to the left-most 7 bit byte of the word. JFN's and 
terminal designators are not legal in string pointers. The 
special cases of the P field equal to 5X or 6X are sometimes 
meaningful. This is used (for example) in the accounting 
JSYS's which have optional account strings or numbers and 
the P field 5X designates an account number. 



Normally, strings being read are assumed to terminate 
on a null (zero) byte. Where this is not the case, another 
argument is necessary. This argument specifies the negative 
number of bytes in the string. 
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When not otherwise specified, a string written by a 
JSYS is terminated with a null byte. 

When a string is read, the string pointer which was 
presented in an accumulator is returned in that accumulator 
updated to point to the character after the terminating 
character of the string. This means an LDB would re-read 
the character which terminated the string read operation. 
However, when a string is written which has a null character 
tacked onto the end, the string pointer which was presented 
in an accumulator is returned in that accumulator updated to 
point to the null character such that the next IDPB would 
write over the null character. When a string is written 
which has an arbitrary terminating character, the string 
pointer which was presented in an accumulator is returned in 
that accumulator updated to point one byte position after 
the terminator such that the next IDPB would append to the 
string without wiping out the arbitrary terminator. 



UNIVERSAL FORK HANDLE 

Several JSYS's take an argument called a fork handle. 
This is an 18 bit quantity. 

400000 current fork 
-1 superior fork 
-2 top level fork 

-3 current fork and all its inferiors 
-4 all of the current fork's inferiors 
-5 all forks in the job 

A fork handle may also be a number between 400001 and 400020 
This is a relative handle on a fork which is only valid for 
a single process. This handle is in fact a dispatch into a 
fork handle table in the PSB of a process. 



FORK/FILE HANDLE 

A few JSYS's take an 18 bit argument called a fork/file 
handle. This handle is either a fork handle (as defined 
above) or a JFN. Note that string pointers and terminal 
identifiers cannot be specified with the handle. This is 
not a limitation of the handle, however, since the 
operations which use the fork/file handle are used for 
changing page maps. Such operations are not meaningful for 
string pointers or terminals. 
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TENEX DATE AND TIME STANDARDS 

In TENEX, the day 1 is. November 18, 1858. This is 
consistent with the Smithsonian Astronomical Date Standard 
which is used by several computer systems. The date 
uniformly increases by one for each day of the week since 
the day 1. Internal dates are number of days since November 
17, 1858 at Greenwich, and thus may be a day ahead of the 
local date. 

The internal time of day standard for TENEX is seconds 
since midnight (with midnight=0) , Greenwich Mean Time (GMT). 

The JSYS's which convert times and dates change from 
local times and dates to GMT times and dates and vice versa. 

The internal format date and time are each 18-bit 

quantities. The date and time frequently occur in a 36-bit 

word as a JSYS argument or value returned; in these cases 

the date is always in the left half and the time in the 
right half. 



NUMBER BASES USED IN THIS MANUAL 

Except where otherwise noted, numbers used in this 
manual are octal, including the definitions of JSYS's. 
Where specific bits in words are indicated, these are 
numbered in decimal with the left most bit of the word 
called B0 and the right most bit of the word called B35. 



ABBREVIATIONS 

The following abbreviations are used in this manual: 

B0, Bl, etc. bit 0, bit 1, etc. of a computer 

word 

LH left half (B0-B17 of a word) 

RH right half (B18-B35 of a word) 

PSI pseudo-interrupt 
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LOGGING FUNCTIONS 



INTRODUCTION 



The JSYS's defined in this section are used to initiate 
and delete jobs from the system as well as to append entries 
about these jobs to the accounting files, 
n <ACCOUNTS> FACT .SYS". If for any reason the primary fact 
file becomes fouled or indefinitely hung up, increasingly 
higher version numbers of the file will be used. The 
highest version number then becomes the primary file. 
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LOGIN 



JSYS 1 



Logs a job onto the system. Useful only for logging in from 
an idle terminal on which a +C has been typed, 

ACCEPTS IN 1: directory number under which one can log in 
for "who is on" table and file directory 
specification. 

2; string pointer to beginning of password string 
in the address space of caller. 

3: account number in bits 3-35 if bits 0-2 = 5, 
else a string pointer to an account string in 
the address space of caller. If the normal 
terminating null byte is not seen, the string 
is terminated after the 8th full word is 
processed. 

LOGIN 

RETURNS +1: unsuccessful, error code in 1 

+2: successful with 1 containing date? and time of 
last login (in system internal format, see 
Introduction) . String pointers (where used) 
updated in 2,3. 



If successful, the user to system access words will 
have been set up, the job table updated, and a "TENEX- LOGIN 
message" appended to the accounting file. A "logged in" 
message is also typed on the logging terminal by this JSYS. 

LOGIN ERROR MNEMONICS: 



LGINXl illegal account number or string 

LGINX2 illegal directory number for logging in 

LGINX4 password does not match 

LGINX5 already logged in 
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CRJOB 



JSYS 2 



Creates a new job (optionally logs it in) 

NOT IMPLEMENTED YET 

ACCEPTS IN 1: terminal number of primary input file which 
will be attached to the job in bits 20-35 if 
left half is and bit 18 is on, else string 
pointer to input file name for primary input. 
Name must be terminated by a legal file name 
terminator which includes null (same action as 
"space") • 

2: terminal number of primary output file in bits 
20-35 if left half is and bit 18 is on, else 
string pointer to output file name for primary 
output. 

3: -1 means don't log in the job, or: 

directory number under which one can log in. 

4: (required if 3 did not contain -1) 

string pointer to beginning of password string 
in address space of caller 



5, 



(required if 3 did not contain -1) 

account number in bits 3-35 if bits 0-2 

else a string pointer to an account string in 

the address space of caller. If the normal 

terminatinq null byte is not seen, the string 

is terminated after the 8th full word is 

processed. 

CRJOB 



RETURNS +1: unsuccessful, error number in 1 

+2: successful, job number in 3, string 
pointers (where used) in 1,2,4,5 
returned updated. 

CRJOB will assign the JSB, open the PMF, attempt to open the 
primary I/O files, create a top level Exec fork and start 
the Exec at its startup entry, and if login is invoked will 
do all the things the LOGIN JSYS does on success. 
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CRJOB ERROR MNEMONIC? 



CRJBXl 
CRJBX2 
CRJBX3 
CRJBX4 
CRJBX5 
CRJBX6 
CRJBX7 



cannot open primary input file 

cannot open primary output file 

illegal account number or string 

tty unavailable for attaching to this job 

illegal directory number for logging in 

no room in system 

password does not match 
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LGOtJT JSYS 3 

Kills a job and appends TENEX- LOGOUT message to FACT file. 
Does not append this message if the job was never logged in, 

ACCEPTS IN 1: the TSS job number of the job to be logged off 
or -1 for the running job. 

LGOUT 

Does not return if argument in 1 was -1 

RETURNS +1: if unsuccessful, error number in 1 

+2: if successful 

LGOUT prints time used (both CPU and console) as well as TSS 
job number and current time and date on the primary output 
device. A similar message is typed on the logging terminal 
by this JSYS. 

Restrictions: argument in 1 must either be -1 or must point 
to a job which is entered under the same user number as this 
job or must be executed by a job which has the LOG special 
privilege. "Suicide" is only permitted if the job number in 
1 was -1 (i.e., if the job number presented to LGOUT is the 
same as that of the running job, the error return will 
result) . 



LGOUT ERROR MNEMONICS : 

LOUTXl: argument in 1 points to job which violates 

restrictions above 
L0UTX2: argument in 1 is illegal job number 
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CACCT JSYS 4 

Changes the account number for subsequent charges to the 
currently entered job. 

ACCEPTS IN 1: account number in bits 3-35 if bits 0-2 - 5, 
else a string pointer to the new account 
string in the address space of caller. If the 
normal terminating null byte is not seen, the 
string is terminated after the 8th full word 
is processed. 

CACCT 

RETURNS +1: if unsuccessful, error number in 1 

+2: if successful, updated string pointer in 1 



Makes a "changed account" entry in the FACT file. 
Changes account number in JSB, resets all "charged 
quantities" to 



CACCT ERROR MNEMONICS: 

CACTXl: illegal account number or string 
CACTX2: not loaqed in 



LOGGING JSYS's Section 1 l-September-73 Page 7 

EFACT JSYS 5 

Makes an arbitrary entry to FACT file. 

ACCEPTS IN 1: LH : negative size of entry 

RH: pointer to beginning of entry (size bits 
of entry will be updated by the system from 
the negative size specified) 

EFACT 

RETURNS +1: if unsuccessful, error number in 1 

+2: if successful 

EFACT returns successfully without making an entry in the 
FACT file if monitor flag B0 (see SMON and TMON, this 
section) is off. 

Restrictions: this JSYS may be called only by the monitor or 
by processes which have the special capability LOG enabled. 

EFACT ERROR MNEMONICS: 

EFCTXl: LOG special capability not enabled 
EFCTX2: entrv too big (>=64 words) 
EFCTX3: trouble with FACT file 
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SMON JSYS 6 

Switches various monitor flags on/off (in in-core monitor 
and also on drum/disc image of monitor) 

ACCEPTS IN 1: mask of flags to change 

2: new bit values for flags 
indicated by 1 bits in 1 

SMON 

RETURNS +1; always 

Requires LOG special capability. 

Generates illegal instruction PS I on error conditions below. 

SMON ERROR MNEMONICS: 

SM0NX1: LOG special capability not enabled 



TMON JSYS 7 

Tests to see if various monitor flags are on/off 

ACCEPTS IN 1: Mask word of flags to be tested: 

B0 tests fact file enabled 

TMON 

RETURNS +1: all flags tested are off 

+2: any of the flags tested are on 
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JSYS ' s FOR REFERENCING FILES 

INTRODUCTION 

This section details the JSYS's for all normal 
references to files. All files in the system, including the 
system's File Directory, are normally referenced with these 
JSYS's. The privileged operations for directly referencing 
the disc, etc. are described in section 10. 

The JSYS's for handling subroutine files are still 
being specified and are not included at this writing. 

File Handles 

It is essential to have handles for referring to files 
which can be contained in a few bits and do not require 
extensive lookup procedures for each reference. The file 
name is the fundamental handle on a file, but the name fits 
neither criterion above. Therefore in TENEX, files are 
referenced by handles called JFN's (Job File Numbers). The 
JFN is a small number (currently 0-155 octal) which is 
assigned to a file name by using the GTJFN (or GNJFN) JSYS. 
The same numeric handle is global to the entire job; that 
is, each process in a job may reference a file using the 
same JFN. However, the handle is not valid between jobs. 
That is, JFN 2 in TSS job 11 will generally be a handle on a 
completely different file from JFN 2 in TSS job 18. 

File References in TENEX 

All file operations in TENEX are initiated by acquiring 
a handle (JFN) on the file using the GTJFN (or GNJFN) JSYS. 
Some file operations such as deleting the file, renaming the 
file, and status queries about the file descriptors may be 
performed immediately after a handle is acquired for the 
file. Other operations, particularly any data transfer 
operations, require that the file be opened by performing an 
OPENF JSYS on the JFN. When opening a file, such things as 
the byte size to be used on the file for byte I/O operations 
and the access requested to the file are specified. Several 
implicit initialization operations are invoked when a file 
is opened which will affect subsequent references to the 
file. For example, the byte pointer is normally preset to 
the beginning of a file on opening the file such that the 
first sequential input operation accesses the beginning data 
of the file. 
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Sample Program 



A sample program follows which acquires handles and 
opens both an input and an output file, then copies data 
from the input file to the output file in 7 bit bytes until 
the end of the input file is encountered. This program is 
highly specialized in that it will not properly copy 
arbitrary format (in particular randomly accessed) input 
files and is not anything like the general form of the 
EXEC's COPY command. 



START: RESET 

HRROI 1, [ASCIZ / 
INPUT FILE: /] 

PSOUT 

MOVSI 1,100003 

MOVE 2, [XWD 100,101] 

GTJFN 



JRST START 
MOVEM 1,INFIL# 

START1: HRROI 1, [ASCIZ / 

OUTPUT FILE: /] 
PSOUT 

MOVSI 1,46 0003 
MOVE 2, [XWD 10 0,101] 
GTJFN 



LOOP: 



JRST START 1 
MOVEM 1,0UTFIL# 
MOVE 1,INFIL 
MOVSI 2,7B23 
HRRI 2,201000 
OPENF 

JRST START 
MOVE l,OUTFIL 
MOVSI 2,7B23 
HRRI 2,101000 
OPENF 

JRST START 
MOVE 1,INFIL 
BIN 

MOVE 3,2 
GTSTS 



;type out string "INPUT FILE: 



; GTJFN, short form, input from 
;and output to primary I/O device 
; accept existing "old" file only 
; start over again on failure return 
;save the JFN 



;type out string "OUTPUT FILE 



; GTJFN, short form, input from 
;and output to primary I/O device 
;file is for output use, print 
;file type [new, old, etc. ] 
confirmation carriage return 
;is mandatory 

;try again on error return 
;save the JFN 



;open file for input, 7 bit bytes, wait 

;if file is busy 

;start all over again on failure 



;open file for output, 7 bit bytes, wait 

;if file is busy 

;start all over again on failure 

; input a byte from input file 

;save the byte in 3 

;get the status of input file 



FILE JSYS's Section 2 



1- September- 7 3 



Page 



DONE 



TLNE 


2,1000 


JRST 


DONE 


MOVE 


2,3 


MOVE 


l,OUTFIL 


BOUT 




JRST 


LOOP 


HRRZI 


: 1,400000 


CLZFF 


i 


HALTF 


■ 


END 





;past EOF? 
;yes, done 
; res tore the byte to 2 

; output a byte to output file 



;close all files and release all JFN's 
;for this process 
;now quit 



File Names 



File names in TENEX are composed of five identifiers. 
These are device, directory name, file name, extension, and 
version. These five items uniquely identify any file 
accessible to a user on the system. The device name 
identifies on what device in the system the file is 
contained. The directory name gives the directory under 
which the file appears. The file name and extension and 
version identify a particular file in the directory given by 
the device and directory name. 

The character set from which these identifiers may be 
constructed is composed of the upper case letters, digits, 
and punctuation marks found in the range 40-137 in the ASCII 
set with the exception of the characters period : ; < > = •*- 
* @ space and comma. These punctuation marks may appear in 
an identifier if they are preceded by a control-V. The 
control-V is not part of the identifier. Lower case letters 
may be used, but they are equivalent to the corresponding 
upper case letters. This is done so that all file names may 
be typed on upper case only terminals such as model 33 
Teletype terminals. The punctuation marks listed above as 
exceptions are used as delimiters for various fields of the 
file name and while their use within a particular field may 
not be ambiguous from a syntactic view, a blanket 
restriction on their use is made for simplicity. 



The general form for a file name is: 

device: <directory name >_name.ext|_vers ion number ; T ; Pp rotec tion 
specification ;Aaccount string 



The underlined 
representative . 



characters 



are real; 



the 



rest 



is 



If any of the fields of the name are omitted, the field 
may be supplied by the program, or from a standard set of 
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default values which are described with the GTJFN JSYS 
definition. 

Recognition is done on file names in a uniform manner 
regardless of the source of input, or the intended use of 
the file. The program can control certain aspects. 
Whenever an alt-mode is input from memory or file, the 
portion of the field input prior to the alt-mode is looked 
up according to which field is currently being input. A 
match is indicated if the input string either exactly 
matches an entry in the appropriate table, or is an initial 
substring of exactly one entry. In the latter case, the 
portion of the matching entry not appearing in the input 
string is output on the output file. The fieid terminator 
is output also, and recognition is done on successive fields 
with a null string as input, or if not possible, the fields 
are defaulted. If the file name cannot be uniquely 
determined, as many fields as possible are recognized and a 
bell is output signifying that more input is required. If 
the string input cannot possibly match any existing file 
name by appending more characters, an error return results. 

Control-F behaves like alt-mode except recognition is 
not carried out past the current field. This allows the 
name to be recognized, for example, but not the extension. 

If an alt-mode is not used, then each field is 
delimited as indicated in the general form above, and the 
name so specified must exactly match some existing file name 
unless the program specifies that new file names are allowed 
(i.e. an output file) . Without alt-mode or control-F, no 
recognition is done but completely omitted fields will be 
defaulted if the program has specified default values. The 
complete file name is specified whenever all fields have 
been recognized, or a comma, space, or carriage return is 
input. Confirmation of file names is described with the 
GTJFN JSYS definition. 

Editing characters are recognized while inputting file 
names as follows: 

+A deletes one character from the current field. If 
no characters remain in the current field, a bell 
is output. 

+W deletes the current field. If the current field 
is null, a bell is output. 

tX causes the file name gathering operations to be 
aborted, types «"*-«- carriage return-line feed and 
then restarts the file name gathering operation. 
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tR retypes the entire name as specified so far and 
awaits further input. 

If the specific call to GTJFN so permits, a star may 
appear in any of the directory name, file name, extension, 
or version fields. A star means "wild card" and will match 
anything. Upon completion of the GTJFN operation, the JFN 
returned will reference the first file found scanning in 
directory order which is: 

In reverse by version number 

In order of creation by extension 

In alphabetic order by name 

In numeric order by directory number. 

Normally, a program accepting stars in file names will be 
prepared to reference all of a class of files. 

File Access Protection 

Because TENEX must service a diverse user community, it 
is essential that access to files be protected in a fairly 
general way. Generally, access to a file depends on two 
things: the kind of access desired, and the relation of the 
program making the access to the owner of the file. A 
simple protection scheme has been implemented in which the 
only possible relationships a program may bear to the file's 
owner are: 

1. The directory currently connected to the job 
under which the program is running is the same as 
the owning directory ("self") . 

2. The directory currently connected to the job 
under which the program is running is in the same 
group as the owning directory ("group"). 

3. Neither 1 nor 2 ("others"). 

Six kinds of access are distinguished. They are: 

1. read 

2. write 

3. execute 

4. append 

5. access as specified in the page table of the file 

6. not used 

The above six protection types and three relationships 
are related by 18 bits (a 3 by 6 binary matrix) in which a 
one indicates that a particular access is permitted for a 
particular relationship. 
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There are 36 groups available in TENEX. Both users and 
directories belong to groups. Relationship 2 above is 
satisfied if both the connected directory and the owning 
directory belong to the same group. Groups are assigned by 
administrative fiat. 



File Consistency 

A TENEX file may be read and written in by any number of 
jobs at the same time. Readers instantaneously see changes 
produced by writers. In most cases it is undesirable for a 
file to have both readers and writers or more than one 
writer. Therefore, each open file in the system can be 
opened in "thawed" mode or "frozen mode". If frozen, then 
all readers see an unchanging file, i.e., there can be no 
writers if there are readers and vice versa, and there can 
be at most one writer. If thawed, there can be any number 
of readers or writers. The mode of access is specified by 
the program when the file is opened (see OPENF JSYS) . If 
the mode specified is not the same as the file's current 
mode, the OPENF will fail. The file's current mode is 
determined by the mode specified by the first opener. 
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Primary Input and Output Files 

Each fork (process) in a TENEX job has a primary input 
file and a primary output file. Both are normally the 
controlling terminal, but can be changed to other files 
(with SPJFN, described in this section) . The primary input 
and output files are referenced with designators 100 and 101 
respectively. Programs should be coded to do their 
" terminal " I/O to these designators, so that they can be 
used with command files without modification; only in 
extreme cases should a program reference its controlling 
terminal directly (designator 0, ,777777). 



Methods of Data Transfer 

Most I/O in TENEX is done sequentially by bytes, as shown in 
the sample program above. This form of data transfer may be 
used with any file. A pointer maintained in the monitor is 
implicitly initialized when the file is opened, and advanced 
as data is transferred. For files on disk, there are two 
other possibilities. First, random access byte I/O is 
possible through the use of the SFPTR JSYS or RIN/ROUT (see 
same) . Second, entire pacres of data may be transferred with 
the PMAP JSYS. 



End of File Pointer 

For disc files TENEX maintains an end of file pointer, 
which is the highest byte address in a file to which byte 
output has been done. Attempting to read beyond this point 
in the file with byte input will produce an end-of-file 
condition, which can be detected with GTSTS and will produce 
a pseudo-interrupt if the appropriate channel is enabled 
(see I/O errors paragraph, next, and section 5). 

Doing output by pages (PMAP JSYS) does not affect this 
pointer; thus it is possible for a file to contain pages of 
data beyond the "end of file". 
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Input/Output Errors 

While performing I/O or I/O related operations, it is 
possible to encounter one or more error conditions. Some of 
these are user-caused errors (e.g. illegal access attempts) 
while others are I/O device or medium errors. TENEX flags 
such error conditions by setting error bits in the JFN 
status word and by initiating pseudo-interrupt requests on 
the appropriate channels (see section 5) . If the fork in 
which an I/O error occurs is not prepared to handle the 
pseudo-interrupt request, it is changed into a fork 
terminating condition with the expectation that the fork's 
immediate superior will handle the error condition. The 
TENEX EXEC is prepared to detect and diagnose I/O errors; 
so, a fork running directly beneath the EXEC need not do its 
own I/O error handling unless it chooses to do something 
special on I/O errors. 

I/O errors can occur while a fork is executing ordinary 
machine instructions as well as JSYS's. For example, if a 
PMAP operation is done which maps a page of a file into a 
page of a fork, tlie file I/O transfer will not actually 
occur until a reference is made by the fork to that 
particular page of the fork. If there is an I/O error in 
the transfer, it is detected at the time of this reference. 

An attempt to do I/O to a terminal which is assigned to 
another job (as a controlling terminal or with ASND) 
normally produces an error, but is legal if the process has 
the WHEEL special capability enabled. 



Note: page numbers 9-14 are reserved for expansion of this 
introduction . 
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GTJFN JSYS 20 

Assigns a JFN to a file name for this job. Accepts a string 
(from a string pointer, a file, or both) of the form: 

device : < directory >name . extension ; version ; T ; Pprot ; Aacct 

The maximum number of JFN's a job may have in use is 
currently over 10 0. 

Two types of calls to GTJFN, short and long, are possible. 
They are distinguished by bit 17 of ACl. 

Short GTJFN call: 

In the short call, the file name can be taken from a 
string or a file (here "file" includes terminal, 
primary input file, etc.), but not both. The device, 
directory, name, extension, etc. are defaulted to the 
standard system values given below, if not specified by 
the input string or file. 

ACCEPTS IN 1: B0-B8 and Bll,Bl2: flags - see below 
Bl6: ON to cause 2 to be taken as 

IN JFN, , OUT JFN 

OFF to cause 2 to be 

taken as string pointer 
B17: ON. 
RH: default version (usually 0; see below) 

2: source designator for file name, i.e. 

string pointer or XWD input JFN, output JFN, 
according to B16 of 1. 

To omit either JFN, give 377777. 

(the output JFN is used for printing the 

rest of recognized names). 

GTJFN 

RETUPvNS +1: failure, error code in 1 

+2: success, JFN assigned in RH 1, 

flags in LH 1 as described below, 

updated string pointer in 2 (if pertinent) 



FILE JSYS's Section 2 



l-September-73 



Page 16 



Long GTJFN call: 

In the long GTJFN call, input may foe from both a string 
and a file. If both are given, the string is used, 
then the file is used if more characters are needed. 
Also, in the long call the caller has the option of 
specifying non-standard" default values for device, 
directory, name, extension, etc, and of specifying the 
JFN he wishes assigned, 

ACCEPTS IN 1: RH: pointer to a table starting at E in the 

caller's address space. 
B17: OFF 



2: main string pointer. if none. 



at E 
E+l 
E+2 
E+3 
E+4 
E+5 
E+6 
E+7 

E+10 



XWD flags (see below) , default version number 

XWD input JFN, output JFN. 377777 for none. 

DSP device 

DSP directory 

DSP name 

DSP extension 

DSP protection (numeric) 

DSP account (string or numeric) 

desired JFN if flag B9 on 



DSP means default string pointer. If any of these is 0, the 
system default for that field is assumed (see below) . 
Numeric values (E+6, E+7) are represented by the form 5B2+N. 

GTJFN 



RETURNS +1: failure, error code in 1 

+2: successful, assigned JFN in RH 1, 

updated string pointer in 2 (if pertinent) 
flags in LH 1 as described below. 
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Flags accepted by GTJFN (in 1 in short call, E in long 
call) : 

B0 for output use 

(affects version number defaulting, see below) 
Bl new file only 
B2 old file only 
B3 print the appropriate one of the following messages: 

[NEW FILE] 

[NEW VERSION] 

[OLD VERSION] - 

[OK] non-directory device, B4 off 

[CONFIRM] non-directory device, B4 on 
B4 confirmation required 
B5 temporary 

B6 retype whole name when complete 
B7 no access by other forks 
B8 ignore "deleted" bit in descriptor block 

(useful for undeleting files) 
B9&B10 00,01 means do not use E+10 

10 try to assign JFN at E+10, error on failure 

11 try to assign JFN at E+10, assign some other 

JFN on failure 

Bll Accept input (first type) file group descriptor as 
defined below. If any **s in string or in 
defaulted fields, assign JFN to first file in 
group. Verify that non-* fields are old or new 
per Bl and B2 in the same manner whether or not 
*'s are present. 

B12 Accept output (second type) file group descriptor 
as defined below. Do not assign JFN to file even 
if no **s input. 

Bl3 Return flags in LH 

On success GTJFN returns the following flags in 1 if flag 
Bll, B12 or B13 were on in the call. 

B0 * for device field 

Bl * for unit 

B2 * for directory 

B3 * for name 

B4 * for extension 

B5 * for version 

B6 use highest version 

B7 use next higher version 

B8 use lowest version 

B9 protection given 

Bl0 account given 

Bll ;T given 

B12 complement of B8 in call 

Bl3 always 



FILE JSYS's Section 2 



l-September-73 



Page 18 



Flags B0-B5 are set whether the * came from input or 
from the default string. Flags B6-B8 apply when the 
version is input as or defaulted to 0, -1, and -2 
respectively. Bits 12 and 13 control inclusion of 
deleted and undeleted files by subsequent GNJFN's. On 
means that class will be skipped, off means that class 
will be included, e.g. 10 means skip deleted files, 
include undeleted files. 



System Default Values 

The following file designator field values are used 
when the input does not specify the field and the GTJFN 
call does not give a default: 



device 

directory 

name 

extension 

version 

protection 

account 



DSK: 

connected directory if device is DSK: 

none 

null 

see below 

directory's default protection 

LOGIN account 



Version Number Defaulting 

Normal version number defaulting is specified by in 
Rli of 1 (short call) or E (long call) and is as 
follows: If "for output use" flag (B0) is off in the 
call, the highest existing version is used; if this 
flag is on, the next higher version number is used. 
Other default version specifications are: a number from 
1 to 131071, to specify defaulting to that version; -1, 
to indicate the next higher version; -2, to indicate 
lowest existing version, -3 = *. 

Terminating Character 

GTJFN always reads the terminating character after the 
file name string. To get that character, use BKJFN 
then BIN. 

Confirmations are: 



tl, tJ, +L, +M, ESC, EOL, SPACE, COMMA, @ , *- 

File Group Descriptors 

A "file group descriptor" is a TENEX file name with one or 
more of the fields replaced with *'s. File group 
descriptors are used in conjunction with the GTJFN and GNJ-FN 
JSYS's to obtain "indexable file handles" which permit 
programs to input "file group descriptors" and to loop over 
all of the designated files. 
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There are two types of file group descriptors, which are 
similar in syntax but different in meaning. The first 
allows looping over an existing group of files in the 
directory and is generally used for input files. The 
second, less common, type is used for output files in 
two-argument operations such as the Exec COPY command. In 
this case *• s mean "use the current value of corresponding 
field from the input descriptor" rather than "index this 
field over all existing values". The second type provides 
the capability of processing a group of files to yield 
another group of files. 

Internally, an "indexable file handle" is a 36-bit quantity 
consisting of flags (left half) and a JFN (right half) . The 
use of Bll and B12 in the flag word of the GTJFN JSYS allows 
it to input file group descriptors of both types, returning 
an indexable file handle to the caller. The GNJFN JSYS 
steps an indexable file handle representing a file group 
descriptor of the first type to the next file in sequence. 
For file group descriptors of the second type, the user 
program will generate successive file names. 

In the first type of file group descriptor, generally used 
for input files, GTJFN determines that at least one value 
exists for each field for which an "*" is given and assigns 
a JFN to the first file in the group. 

In the second type of file group descriptor, generally used 
for output files, "*" means "copy field from input file 
name". GTJFN collects a string and stores the non-* parts 
of it in the JSB for access by the JFNS JSYS, but does not 
assign the JFN to a specific file. Non-* fields preceding 
the first * are verified for existence if B2 of the flag 
word is on in the call. 

For both cases, it is possible to specify "*" for default 
name, extension, version, and directory by having the 
appropriate default string be an "*" . Also, if the version 
number is defaulted, the actual version will be determined 
independently for each file in the group. Hence in such 
cases nothing is printed for version after altmode 
termination, and appropriate flags are returned to the 
caller for communication to GNJFN. More specifically, after 
altmode, GTJFN does not print rt ;" and a default version if 
either: Bll was on in call and an * has been entered and 
default version given in call is 0, -1, or -2, or B12 was on 
in call and default version given in call is 0, -1, or -2. 
The confirmation message will be either [CONFIRM] or [OK] if 
an * has been input since some of the files in the group 
could be old and others new. More specifically, the 
confirmation printout is changed to [OK] or [CONFIRM] if 
either: Bll was on in call and at least one * has been 
entered, or B12 was on in call. 
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GTJFN ERROR MNEMONICS: 



GJFXl: 
GJFX2: 
GJFX3 : 
GJFX4 : 
GJFX5 : 
GJFX6: 

GJFX7: 

GJFX8 : 

GJFX9; 

GJFX10: 

GJFXl 1: 

GJFX12: 

GJFX13: 

GJFX14 ; 

GJFX15: 
GJFX16: 
GJFX17: 
GJFX18: 
GJFX19: 
GJFX20: 
GJFX2 1 : 

GJFX22: 
GJFX23: 
GJFX24: 
GJFX25: 
GJFX26: 
GJFX27: 

GJFX28 
GJFX29 
GJFX30 
GJFX31 
GJFX32 
GJFX33 
GJFX34 
GJFX35 
GJFX36 



illegal JFN 

not an available JFN 

no JFN available 

illegal character in file name 

input field too large (>39 chars) 

too many device fields or device 

not specified first 
too many directory fields or 

directory after name 
> not following < 
too many name fields 
non-numeric version 
version specified twice 
too many account fields 
too many protection fields 
non-numeric or negative or unrecognized 

protection 
improper confirmation character 
no such device 
no such directory 
no such name 
no such extension 
no such version 
no such file (it was expunged from the 

directory during the execution of the GTJFN) 
no room in JSB 
no room in directory 
no new files 

non-null name used with non-directory device 
non-null extension used with non-directory device 
old file not allowed 

(bit 1 of flags set & old file specified) 
mountable device not mounted 
device not available to this job 
string account not allowed 
illegal * 

* for name in empty directory 
null string not allowed for name 
un-qxaoted "?" used in a file-name 
read access not allowed for requested directory 
system error-requested directory cannot be read. 
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GNJFN 



JSYS 17 



Assigns JFN to next file in group as determined by its 
current association and flags transmitted by user from GTJFN 
to GNJFN. Scans only in internal directory order. 

ACCEPTS IN 1: Indexable file handle (as returned by GTJFN) 
LH: flags - see GTJFN description 

RH: JFN 

GNJFN 



RETURNS 



+1: Error, or no more files, JFN released if no 
more files. Occurs on first call if no * 
flags on in LH of 1. 



+2: Same JFN assigned to next file, previous 
closed if open. 



file 



Bits returned in LH of 1 indicate which fields 
were changed as follows: 

14 - directory changed 

15 - name changed 

16 - extension changed 

Note that GNJFN makes use of the flags returned in LK of 1 
by GTJFN to specify which fields are being indexed and what 
the default version is. The flags returned by GNJFN should 
not be used as an argument to GNJFN. That is, do not update 
the GTJFN flags in the user program with those from GNJFN. 

Generates illegal instruction PSI on error conditions below. 



GNJFN ERROR MNEMONICS: 



DESXl: illegal value for designator 

DESX2: terminal not available to this job 

DESX3: no name for this JFN 

DESX4: terminal designator or string pointer not legal 

GNJFXl: cannot close the file 

OPNXl: file open 
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OPENF 



JSYS 21 



Opens a specified file 
ACCEPTS IN 1: the JFM 



2; B0-B5: BYTE SIZE (max 36) 
B6-B9: FILE DATA MODE 

0: normal mode (dump I/O illegal) 
17s dump mode (device dependent; 
cannot do byte I/O; byte size 
ignored) 

Other modes are used in some devices. See, 
for example, NETWORK: later in this section. 

(see sec, 4) 



B10- 


-17: Device dependent 


B18: 


i Not used 


B19 : 


\ read 


B20; 


: write 


B21 


: execute 


B22- 


: append 


B23 


: access as specifie 



by the page table of 



B24: 

B25 
B26 
B27 
B28 



B26 



the file 

protected entry only 

NOT IMPLEMENTED YET 

thawed 

always wait if file is 

do not change eiccessed 

never wait, give error 

busy * 



busy * 
dates 
if file 



is 



and B2 8 both off, normal 
device-dependent default on 
waiting: e.g., wait for 
LPT : , not for DSK : . 



OPENF 

RETURNS +1: unsuccessful, error # in 1 

+2: successful 

OPENF ERROR MNEMONICS: 

OPNXl: already open 

0PNX2: file doesn't exist 

0PNX3: read access not allowed 

0PNX4: write access not allowed 

0PNX5: execute access not allowed 

0PNX6: append access not allowed 

0PNX7: device assigned to another job 
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0PNX8 : 
0PNX9 : 
OPNX10 
0PNX12 
0PNX13 
0PNX14 
0PNX15 
0PNX16 
OPNX20 
0PNX21 
OPNX22 

DESXl: 
DESX3: 
DESX4: 
SFBSX2: 



device is not mounted or is off-line 
file busy 
no room 

list access not allowed 
illegal access 
illegal mode 

non- read/write access not allowed 
file has bad index block 
foreign host dead (NETWORK only) 
rejected by foreign host (NETWORK only) 
byte size does not match RFC specifications 
(NETWORK, receive connections only) 
illegal value for designator 
no name for this JFN 

terminal designator or string pointer not legal 
illegal byte size 
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CLOSF 



JSYS 22 



Closes a specific file or all files 



ACCEPTS IN 1: 



the JFN (if B0 is on, do not release the JFN 
if B0 is off, do release the JFN) 
or -1=> close all files and all JFN's at or 
below this fork (with the exception of the 
primary I/O files and files which cannot be 
closed by the current fork) , but do not 
release the JFN's. 



CLOSF 



RETURN* 



+1: unsuccessful, error code in 1 



+2: successful 



CLOSF ERROR MNEMONICS: 

DESXl: illegal value for designator 

DESX2: terminal not available to this job 

DESX3: no name for this JFN 

DESX4: terminal designator or string pointer not legal 

CLSXl: not open 

CLSX2: not closable by this fork 

all output errors may occur 



FILE JSYS's Section 2 



l-September-73 



Page 25 



CLZFF 



JSYS 34 



CLoZe Fork's Files. Closes all files and/or 
TFN^s at and/or below a specified fork 



releases all 



ACCEPTS IN 1: 



RH: a fork handle 

B0 on, don't close files of specified fork's 

inferiors 
Bl on, don't close specified fork's files 
B2 on, don't release JFN's 
B3 on, don't close any files, only release 

non-open JFN's 
B4 on, unrestrict files opened with restricted 

access for specified fork (fork must be 

self or inferior) 
B5 on, release specified JFN's even if a fork 

is sharing pages with the file 



CLZFF 



RETURNS +1: always, having done nothing if the call was in 
any way illegal 
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RLJFN 



JSYS 23 



Releases JFN's 



ACCEPTS IN 1: the JFN or -1=> all JFI^s which do not specify 
open files 

RLJFN 

RETURNS +1: unsuccessful, error code in 1 

+2: successful 



RLJFN ERROR MNEMONICS: 

DESXl: illegal value for designator 

DESX3; no name for this JFN 

DESX4: terminal desianator or string pointer not legal 

RJFNXl: specified file is open hence JFN 

cannot be released 
RJFNX2: JFN is being used to accumulate a name 

hence cannot be released 
RJFNX3: JFN not accessible from this fork 
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RESET JSYS 147 

Resets and initializes many things about the current fork; 
should be used at the beginning of all programs. 

RESET 
RETURNS +1: always 

In detail, RESET does the following: 

Closes all files and releases all 
JFM's at or below this fork 

Kills all inferior forks 

Clears fork's PSI system 

Clears compatibility entry vector 

Sets the following fields of the 
controlling terminal's mode word 
(rest of word unchanged) 
(see section 4B) : 

Wakeup on every character 

Echo: immediate or deferred 

Lower to upper case input 

conversion off 

Lower case output: do not 

indicate by % 

Control character output control: 
send CR, LF r +G 
simulate EOL, VTAB 
simulate or send FF and TAB 
per Bl and B2 of mode word 
indicate all others with +X 

Sets tab stops every 8 columns 
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JFN STATUS WORD FORMAT 

The two JSYS definitions which follow manipulate 
status word whose format is shown below 



the JFN 



B0: file is open 

Bl: file is ok to read (ie it is open for reading) 

B2: file is ok to write 

B3: file is ok to execute 

B4: ok to reset byte pointer (not append) 

B5: ok to access as specified by page table 

B6 : (not used) 

B7: file is a long file 

B8; set if last read was past end of file 

B9 : bytes read may be in error 

B10: name is associated with JFN 

Bll: an * was typed in one of the file name fields 

B12: JFN being assigned 

B13: file data errors are terminating conditions even if 

error interrupt is armed 
B16: ok to change byte size 
B17: file is restricted to some fork 
B32-B35: data mode, see OPENF 



GTSTS 
Reads the status of a file 
ACCEPTS IN 1: the JFN 



JSYS 24 



RETURN* 



GTSTS 

+1: always, status in 2. If JFN is in any way 
illegal, BlP of 2 will be 
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Writes the status of a file. 

ACCEPTS IN 1; the JFN 

2: the status word (only bits 9, 13 , 17 can be 
changed) 

STSTS 

RETURNS +1: unsuccessful, error code in 1 

+2: successful 

STSTS ERROR MNEMONICS: 

DESXl: illegal value for designator 

DESX2: terminal not available to this job 

DESX3: no name for this JFN 

DESX4: terminal designator or string pointer not legal 



DELF JSYS 26 

Deletes a specified file on a directory device (DSK: or 
DTA: , currently). On DSK:, the file is not really deleted, 
but marked for later deletion by the backup system or with 
DELDF. Does nothing if JFN is assigned to a non-directory 
device. 

ACCEPTS IN 1: the JFN of the file to be deleted, unless B0 
on in CALL ACl. 

DELF 

RETURNS +1: unsuccessful, error code in 1 

+2: successful, file closed (if open), JFN 
released, unless B0 on in CALL ACl. 

DELF ERROR MNEMONICS: 

DESXl: illegal value for designator 
DESX3: no name for this JFN 

DESX4: terminal designator or string pointer not legal 
DELFXl: attempt to deiete a file for which this user 
does not have write permission 
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DELNF JSYS 317 

DELete all but N versions of a File. 

ACCEPTS IN 1: A JFN of a disk file 

2: the number of versions to keep 

Starting with the specified file version, and going down, 
the first N versions are retained and the next are deleted. 

DELNF 

RETURNS +1: unsuccessful, error number in 1 

+2: successful, with the negative of the 
number of files deleted in 2 

Like DELF, DELNF marks the files for deletion. They are 
expunged later by DELDF or LGOUT. 
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Sets the pointer in a file. 

ACCEPTS IN 1: the JFN of the file 

2: the byte number to which the pointer is to be 
set (-1 means to current end of file) 

If the pointer is set beyond the end of file, a later 
BIN/SIN will return a zero byte with an end of file 
indication, (File status bit, EOF PSI if enabled) . On the 
other hand, if an output is done (BOUT/SOUT) , the byte is 
stored at the position specified and the file length is 
updated to contain the new information. 

SFPTR 
RETURNS +1: unsuccessful, error number in 1 
+2: successful 

SFPTR ERROR MNEMONICS: 

DESXl: illeoal value for designator 

DESX3: no name for this JFN 

DESX4: terminal designator or string pointer not legal 

SFPTXl: specified file is not open 

SFPTX2: illegal to reset pointer for this file 

SFPTX3: illegal byte number for pointer reset (eg <-l) 
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JFNS JSYS 30 
JFN to string conversion 

ACCEPTS IN 1: TENEX destination designator, an ASCIZ string 
is written 

2: RH: JFN 

LH: or flags returned in LH 1 by GTJFN 

3: output specification described in detail 
below , for normal which is: 

DEV : <DIR> NAME. EXT; VERS ;T with defaulted fields 
not printed and account and protection also 
printed if B9 or B10 of 2 respectively on 

The detailed description of each bit of this 
argument follows: 

B0-2 device output control 

B3-5 directory output control 

B6-8 name output control (2 is illegal) 

B9-11 extension output control (2 is illegal) 

B12-14 version output control 

B15-17 protection output control 

618-2 account output control 

B21 print ;T if appropriate 

B22 print size in pages 

B23 print creation date 

B24 print write date 

B25 print read date 

B26-30 unused 

B31-35 format control code 

format control bits 

If B31-35 = 0, put nothing between fields 

B35 on -.. punctuate device field through ;T field 
B34 on - tab before fields which might print, 

i.e., those that have format specification 1 or 2 

(except for the first such field) 
B33 on - tab before all (printed) fields except: 

first field 
B32 on - punctuate size & date fields 
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punctuation used 
punctuation is underscored 

device; 

<di rectory > 

name 

^ext 

jversion 

;Aaccount 

TFprotection 

1 T 
^size 

, creation date, write date, read date 



output control specification 



don*t print 

1 always print 

2 suppress if system default 

JFNS 

RETURNS +1: always, updated string pointer (if pertinent) 
in 1 

If the JFN given to JFNS is associated with a file and LH 2 
is 0, JFNS will print the specific file's name, version, 
etc. For instance, it does not print ,, -3" for version even 
if version are being scanned, and of course it does not 
print * , s. 

If the JFN was obtained with the output file group 
descriptor flag (flag B12) case of GTJFN, it will be 
assigned but not associated with a file. In this case if LH 
2 is 0, JFNS will return nulls for non-existent fields and 
the proper values for existent fields. 

In all cases if JFNS is supplied with flag bits in LH 2, it 

will obey them, printing **s for fields whose flag is on, 

and printing version 0, -1, and -2 for B6, B7, and B8 
respectively. 

Generates illegal instruction PSI on error conditions below. 



JFNS ERROR MNEMONICS: 

DESXl: illegal value for designator 

DESX2: terminal not available to this job 

DESX3: no name for this JFN 

DESX4: terminal designator or string pointer not legal 

DESX5: not open 
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FFFFP JSYS 31 
Finds the First Free File Page 
ACCEPTS IN 1: JFN 

FFFFP 

RETURNS +1: with JFN in left half of 1, page number in 
right half of 1, OR -1 in 1 if no free pages 

Generates illegal instruction PSI on error condtions below 

FFFFP ERROR MNEMONICS: 

DESXl: illegal value for designator 

DESX3: no name for this JFN 

DESX4: terminal designator or string pointer not legal 

DESX5: not open 



FFUFP JSYS 211 

Finds the First Used File Page at or beyond a specified page 
number, 

ACCEPTS IN 1: LH: JFN 

RII: starting page number 

FFUFP 

RETURNS +1: failure, error number in 1 

+2: success, page number in RH 1, 
LH 1 preserved. 

FFUFP ERROR MNEMONICS: 

DESXl: illegal value for designator 

DESX3: no name for this JFN 

DESX4: terminal designator or string pointer not legal 

FFUFXl: not open 

FFUFX2: file not on multiple directory device 

FFUFX3: no used page found 
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CPRTF 



JSYS 33 



Changes protection of a file 
NOT IMPLEMENTED YET USE CHFDB 

ACCEPTS IN 1: JFN of file whose protection is to be changed 

2: new protection: 

XWD 500000,18 bit protection. 

Or, later, a string pointer to c 

protection name, 

CPRTF 

RETURNS +1: unsuccessful, error code in 1 

+2: successful 

CPRTF ERROR MNEMONICS: 



DESXl: illegal value for designator 
DESX2: terminal not available to this job 
DESX3: no name for this jfn 

DESX4: terminal designator or string pointer not legal 
CPRTXl: this file's current protection does not 
permit you to change its protection 
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RNAMF JSYS 35 

Renames an existing file to another name 

ACCEPTS IN 1: JFN of existing file to be renamed 

2: JFN of renamed file name (note if the renamed 
file name is that of an existing file, the 
existing file will get marked as deleted in 
such a way that it cannot be undeleted!) 

RNAMF 

RETURNS +1: unsuccessful, error code in 1 

+2: successful, JFN in 2 now talking to same file, 
new name, JFN in 1 gets released,, 



RNAMF ERROR MNEMONICS: 

DESXl: illegal value for designator 

DESX2: terminal not available to this job 

DESX3: no name for this JFN 

DESX4: terminal designator or string pointer not legal 

OPNXl: already open, unopened file names must be used 

RNAMXl: attempt to rename files which are not on same 

device 

RNAMX2: destination non-existent 

RNAMX3: no access to destination 

RNAMX4: no space to do rename 

RNAMX5: destination busy 

RNAMX6: destination has bad page table 

RNAMX7: source non-existent 

RNAMX8: no access to source 

RNAMX9 : source is empty 

RNAMX10 : source busy 

RNAMXl 1: source has bad page table 

RNAMX12: rename to self 
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SIZEF JSYS 36 

Gets length of an existing file 

ACCEPTS IN 1: JFN of existing file 

SIZEF 

RETURNS +1: unsuccessful, error code in 1 

+2 j successful, byte count which referenced the 
last byte written into the file in 2 
# of pages (512 words) in file in 3 

NOTE: Use GTFDB to get the byte size in which the file was 
written. For a holey file the byte count in 2 does not 
necessarily reflect the file's size. 

SIZEF ERROR MNEMONICS: 

DESXl: illegal value for designator 

DESX2: terminal not available to this job 

DESX3: no name for this JFN 

DESX4: terminal designator or string pointer not legal 
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GACTF JSYS 37 

Gets account number or string to which existing file is 
being charged 

ACCEPTS IN 1: JFN 

2: pointer to E where account string (if any) 
will get stored. 

GACTF 

RETURNS +1: illegal, error # in 1 

+2: string returned starting at E r updated string 
pointer in 2 

+3: number returned in 2, with B0 and B2 on for 
consistency with SACTF 

Related JSYS: SACTF, see index 



GACTF ERROR MNEMONICS: 

DESXl: illegal value for designator 

DESX2: terminal not available to this job 

DESX3: no name for this JFN 

DESX4: terminal designator or string pointer not legal 

GACTXl: not multiple directory device 

GACTX2: file not found 
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STDIR JSYS 4 

Translates string to directory number 

ACCEPTS IN 1: if positive use entire string literally for 
exact match 

if negative try to recognize 
if Bl7 is 1, use specified device 
otherwise use default device 

2: string pointer 

3: device designator if B17 of ACl on 

STDIR 

RETURNS +1: no match 



+2: ambiguous 

+3: unique match, directory number returned in 
right half of 1. 

left half of 1, B0 off says user may log in 
under or connect to this directory, B0 on says 
name may only be used for directory 
connection. 

Bl off says user must specify account as 
number, Bl on says user may use alphanumeric 
account string. 

B2 off says print login message only if newer 
than date and time of last LOGIN, B2 on says 
repeat LOGIN message at every LOGIN. 
Appends remainder of string (if any) to 
original string if recognition was invoked and 
updated string pointer is returned in 2. 
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DIRST JSYS 41 

Translates directory number to string 

ACCEPTS IN 1: TENEX destination designator 

2: directory number 

DIRST 

RETURNS +1: unsuccessful, number not in use 

+2: match found, string written to destination, 
updated string pointer (if pertinent) in 1 

Generates illegal instruction P5I on error condtions below 

DIRST ERROR MNEMONICS: 

DESXls illegal value for designator 

DESX2: terminal not available to this job 

DESX3: no name for this JFN 

DESX5: not open 
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BKJFN JSYS 42 

Backs up the pointer in a file by one byte 

ACCEPTS IN 1: TENEX source/destination designator 

BKJFN 

RETURNS +1: unsuccessful, error # in 1 

+2: successful, updated string pointer (if 
pertinent) in 1 (this actually will 
decrement a string pointer) 

BKJFN cannot be used to back up more than one character for 
terminals . 

NOTE: Not implemented for DECtape files. 

BKJFN ERROR MNEMONICS: 

DESXl: illegal value for designator 

DESX2: terminal not available to this job 

DESX3: no name for this JFN 

DESX5: not open 

BKJFXl: illegal attempt to back up terminal pointer twice 

SFPTX2: illegal to reset pointer for this file 

SFPTX3: attempt to reset pointer to before beginning of 
file 



FILE JSYS's Section 2 l-September-73 Page 42 

RFPTR JSYS 43 
Reads position of pointer in file 
ACCEPTS IN 1: JFN 

RFPTR 
RETURNS +1: unsuccessful, error # in 1 
+2 : byte number in 2 

RFPTR ERROR MNEMONICS: 

DESXl: illegal value for designator 

DESX2: terminal not available to this job 

DESX3: no name for this JFN 

DESX4; terminal designator or string pointer not legal 

DESX5: not open 
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CNDIR JSYS 44 

Connects the job to a file directory. 

ACCEPTS IN 1: a directory # to which to connect the job. 

If the sign bit is set, this will just check 
the password without connecting to the 
directory. 

2: a string pointer to a password string 
(optional, not needed if directory is that 
under which job is logged in, or if directory 
does not have password string) 

CNDIR 

RETURNS +1: unsuccessful, error # in 1 

+2: successful, string pointer in 2 not updated 

NOTE: previous file openings remain valid after a CNDIR 

CNDIR ERROR MNEMONICS: 

CNDIXl: incorrect password 

CNDIX3: invalid directory # 

CNDIX4: logged in 

CNDIX5: not logged in 
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RFBSZ JSYS 45 
Reads byte size for a specific opening of a file 
ACCEPTS IN Is JFN 

RFBSZ 
RETURNS +1: with byte size right justified in 2 
Generates illegal instruction PSI on error conditions below 

RFBSZ ERROR MNEMONICS: 

DESXl: illegal value for designator 

DESX2: terminal not available to this job 

DESX3: no name for this JFN 

DESX4: terminal designator or string pointer not legal 

DESX5: not open 



SFBSZ JSYS 46 

Resets byte size for a specific opening of a file 

ACCEPTS IN 1: JFN 

2: byte size 

SFBSZ 

RETURNS +1: always 

Generates illegal instruction PSI on error conditions below 

SFBSZ ERROR MNEMONICS: 

DESXl: illegal value for designator 

DESX2: terminal not available to this job 

DESX3: no name for this JFN 

DESX4: terminal designator or string pointer not legal 

DESX5: not open 

SFBSXl: illegal to change byte size for this jfn 

SFBSX2: illegal byte size 
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SWJFN JSYS 47 

Swaps the association of two JFN's by literally exchanging 
all information cells of each JFN 

ACCEPTS IN 1: JFN 

2: another JFN 

SWJFN 

RETURNS +1: always 

Generates illegal instruction PS I on error conditions below. 

SWJFN ERROR MNEMONICS: 

DESXl: illegal value for designator 

DESX2: terminal not available to this job 

DESX3: no name for this JFN 

DESX4: terminal designator or string pointer not legal 
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PBIN JSYS 73 

Inputs the next sequential byte from the primary input file. 

PBIN 

RETURNS +1: with byte right justified in 1 

Can cause several pseudo-interrupts or fork termination on 
certain file conditions (see Section 5 of this manual) . 

PBIN ERROR MNEMONICS: 

DESXl; illegal value for designator 

DESX2: terminal not available to this job 

DESX3: no name for this JFN 

DESX5: file not open 

10X1: illegal read 

10X4: end of file 

10X5: data error 



PBOUT JSYS 74 

Outputs a byte (sequentially) to primary output file. 

ACCEPTS IN 1: the byte (right justified) 

PBOUT 

RETURNS +1: always 

Can cause several pseudo-interrupts or fork termination on 
certain file conditions (see Section 5 of this manual) 

PBOUT ERROR MNEMONICS: 

DESXl: illegal value for designator 

DESX2: terminal not available to this job 

DESX3: no name for this JFN 

DESX5: file not open 

10X2: illegal write 

10X5: data error 

10X6: attempt to write beyond abs max file length 
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PSOUT JSYS 76 

Outputs a string (sequentially) to primary output file. 

ACCEPTS IN 1: a string pointer to a string in the caller's 
address space, terminated with a null 
character 

PSOUT 

RETURNS +1: always, with updated string pointer in 1 

Can cause several pseudo-interrupts or fork termination on 
certain file conditions (see Section 5 of this manual.) 

PSOUT ERROR MNEMONICS: 



DESXl: illegal value for designator 

DESX2: terminal not available to this job 

DESX3: no name for this JFN 

DESX5: file not open 

10X2: illegal write 

10X5: data error 

10X6: attempt to write beyond abs. max. file length 
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ESOUT JSYS 313 



Error String Output 



Used to report an error in input from the primary input 
stream, to cause re-synchronization of the input 
interaction. 

ACCEPTS IN 1: a string pointer to a string in 

caller's address space, terminated by 
a null character 

ESOUT 

RETURNS +1: always, with updated 
string pointer in 1 

Can cause several pseudo-interrupts or fork termination on 
certain file conditions (see OPENF) 

ESOUT first waits for the primary output buffer to empty, 
then outputs a carriage return, linefeed, question mark to 
the primary output. Next it clears the p>rimary input 
buffer, and finally outputs the argument (error string) to 
the primary output. 

This mechanism is convenient for re-synchronizing 
communication with a user who made a typing error, and 
(possibly) continued to type ahead. It also standardizes 
the format of error messages. 
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BIN JSYS 50 

Does sequential byte input from a source 

ACCEPTS IN 1: TENEX source designator 

BIN 

RETURNS +1: with the byte right justified in 2 

Can cause several pseudo-interrupts or fork termination on 
certain file conditions (see Section 5 of this manual) 

BIN ERROR MNEMONICS: 

DESXl: illegal value for designator 

DESX2: terminal not available to this job 

DESX3: no name for this JFN 

DESX5: file not open 

IOXl: illegal read 

10X4: end of file 

10X5: data error 
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BOUT JSYS 51 

Does sequential byte output to a destination 

ACCEPTS IN 1: TENEX destination designator 

2: the byte right justified 

BOUT 

RETURNS +1: always 

Can cause several pseudo-interrupts or fork termination on 
certain file conditions (see Section 5 of this manual) 

BOUT ERROR MNEMONICS: 

DESXl: illegal value for designator 

DESX2: terminal not available to this job 

DESX3: no name for this JFN 

DESX5: file not open 

10X2: illegal write 

10X5 : data error 

10X6: attempt to write beyond abs. max. file length 
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SIN 



JSYS 52 



Does string input from a source 

ACCEPTS IN 1: TENEX source designator 

2: a string pointer to the caller's address space 

3: => byte terminates 
<0 => negative byte count 

>0 => a positive byte count or use contents of 
4 for terminating byte (whichever happens 
first) 

4: optional right justified byte on which to 
terminate input 

SIN 

RETURNS +1: always, updates string pointer in 2 and in 1 
(if pertinent) and updates count in 3 (if 
pertinent) 

Can cause several pseudo-interrupts or fork termination on 
certain file conditions (see Section 5 of this manual) . 
Updates the file position pointer for subsequent I/O to this 
JFN. If interrupted by an end-of-file PSI , 1, 2, and 3 will 
be updated (where pertinent) to reflect the number of bytes 
transferred before the end-of-file. 

SIN ERROR MNEMONICS: 



DESXl: illegal value for designator 

DESX2: terminal not available to this job 

DESX3: no name for this JFN 

DESX5: not open 

IOXl: illegal read 

10X4: end of file 

10X5: data error 
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SOUT JSYS 5 3 

Does string output to a destination 

ACCEPTS IN 1: a TENEX destination designator 

2: a string pointer from caller's address space 

3: => byte terminates 
<0 => negative byte count 

>0 => a positive byte count or use contents of 
4 for terminating byte (whichever happens 
first) 

4: optional right justified byte on which to 
terminate output 

SOUT 

RETURNS +1: always, updates string pointer in 2 and in 1 
(if pertinent) and count in 3 (if pertinent) 

Can cause several pseudo-interrupts or fork termination on 
certain file conditions (see Section 5 of this manual) . 
Updates the file position pointer for subsequent I/O to this 
JFN. 

SOUT ERROR MNEMONICS: 



DESXl: illegal value for designator 

DESX2: terminal not available to this job 

DESX3: no name for this JFN 

DESX5: file not open 

10X2: illegal write 

10X5: data error 

10X6: attempt to write beyond abs max file length 
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RIN JSYS 54 

Does random input from a file 

ACCEPTS IN 1: JFN 

3: the byte number within the file 

RIN 

RETURNS +1: with byte right justified in 2 

Can cause several pseudo-interrupts or fork termination on 
certain file conditions (see Section 5 of this manual) . 
Updates the file position pointer for subsequent I/O to this 

JFN. 

RIN ERROR MNEMONICS: 

DESXl: illegal value for designator 

DESX2: terminal not available to this job 

DESX3: no name for this JFN 

DESX4: terminal designator or string pointer illegal 

DESX5: file not open 

IOXl: illegal read 

10X3: illegal to change pointer 

10X4: end of file 

10X5: data error 
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ROUT JSYS 55 

Does random output to a file 

ACCEPTS IN 1: JFN 

2: a right justified byte 

3: the byte number within the file 

ROUT 

RETURNS +1: always 

Can cause several pseudo-interrupts or fork termination on 
certain file conditions (see Section 5 of this manual) . 
Updates the file position pointer for sub sequent I/O to this 
JFN. 



ROUT ERROR MNEMONICS: 

DESXl: illegal value for designator 

DESX2: terminal not available to this job 

DESX3: no name for this JFN 

DESX4: terminal designator or string pointer illegal 

DESX5: file not open 

10X2: illegal write 

10X3: illegal to change pointer 

10X5: data error 

10X6: attempt to write beyond abs max file length 
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PMAP 



JSYS 56 



JSYS for mapping pages 



ACCEPTS IN 1 



LH: the source fork/file handle 

RH : a page number 

OR if 1 contains -1 means remove page 

(specified in 2) from fork or file (specified 

in 2) 



2: left half: the destination fork/file handle 
right half: a page number 

3: Access requested as follows 
B2 read access allowed 
B3 write access allowed 
B4 execute access allowed 
B8 trap-to-user on any access 
B9 copy-on-write 

PMAP 



RETURNS 



+1: always 



In general PMAP changes the map of the destination fork/file 
(LH2) so that references to the indicated page go to the 
source page (RHl) . Details vary as described under the 
following 3 cases. 



FILE JSYS's Section 2 l-September-73 Page 56 



CASE ll AC i identifies file, AC 2 identifies a fork 

This changes the contents of the map of the process such 
that addresses in the page specified by the right half of 2 
will actually reference the indicated page of the file. 
This is done by setting up a share pointer in the process 
map to the proper slot in the file's page map. If the file 
page is non-existent, it will be created and a disk address 
assigned. 

The read, write, and execute permission bits are "and"ed 
with the permission specified when the file was opened and 
put into the process map. This "and"ing operation can only 
reduce access capabilities, it will not generate error 
conditions. If the file was opened with "access as 
specified in page table", then the access granted is the 
"and" of the access requested and that in the page table of 
the file. 

CASE 2j_ AC JL identifies a fork, AC 2 identifies a file 

This is the inverse operation of case 1. The page (which 
must be a private page or PMAPX2 error will occur) changes 
ownership from the fork to the file. The fork will still 
have the designated page in its address space, but it will 
have a share pointer to the page in the designated file. 
The disposal bits are irrelevant. The fork's access to the 
page will be modified (possibly reduced) in the same manner 
as described in case 1. If a page already existed at the 
designated page of the file, the former page will be 
deleted. (Note this designated page of the file must have 
been private to the file or PMAPXl error will occur) 

CASE 3; both AC's identify forks 

In this case an indirect pointer is set up from the 
destination page table to the source page table. If the 
destination page previously existed, it is removed from the 
map. The access bits for the indirect pointer are set up 
exactly as specified in 3, but the paging hardware will 
"and" the access bits at each stage of indirection which may 
result in a reduction of the final access granted to the 
destination page. 
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ILLEGAL CASES 

If both AC's designate files or both contain 0, the PMAP is 
considered illecral. 



PMAP generates an illegal instruction PSI on error 
conditions listed below, and can potentially generate other 
PSIs on certain file conditions. 



Note on write-copy and trap-to-user bits 

a) The monitor will permit a write operation into a page 
if either write or write-copy access is indicated. A 
write-copied private page will always have write 
access, with read and execute present if they are 
present in the original pointer. 

b) The monitor will never copy a private page. 

c) GET opens files for read and execute access only. 
Therefore write access will never be found in a shared 
(SSAVE'd) page as the result of a GET. Write-copy may 
be on as determined by the arguments to SSAVE at the 
time the file was saved. 

d) A memory reference to a page having trap-to-user set 
will: 

1. Clear the trap-to-user bit and continue the 
reference. 

2. Request a pseudo-interrupt on channel 21. 

e) Trap-to-user is noticed by the monitor before other 
access restrictions. Illegal read and write are next, 
followed by copy-on-write. 
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PMAP ERROR MNEMONICS: 



DESXl: illegal value for designator 

DESX2: terminal not available to this job 

DESX3: no name for this JFN 

DESX4: terminal designator or string pointer not legal 

DESX5: file not open" 

DESX7: file must be on disk 

PMAPXl: attempt to gain illegal access to file 

PMAPX2: attempt to execute PMAP with one of illegal 

cases 

FRKHXl: illegal fork handle 

FRKHX2: cannot manipulate a superior fork 

FRKHX3: cannot reference multiple forks 
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RPACS JSYS 57 

Reads the accessibility of a page 

ACCEPTS IN 1: LH: fork/file designator 

RH: a page number in the file 

RPACS 

RETURNS +1: always with access information in 2 

B2 read access allowed 

B3 write access allowed 

B4 execute access allowed 

B5 page exists 

B6 indirect pointer (1 or more) 

B8 trap-to-user 

B9 copy-on-write 

B10 private 

B20 read access allowed in first pointer 
B21 write access allowed in first pointer 
B22 execute access allowed in first pointer 
B23 page exists in first pointer 
B26 trap-to-user in first pointer 
B27 copy-on-write in first pointer 

Note that the left-half bits are the result of tracing any 
indirect pointer chains; whereas, the RH contains 
information about the first pointer only (the one in the map 
directly indicated by the argument) . The LH and RH 
information will be different only if an indirect pointer 
was encountered in the first map. In this case, bit 6 will 
be set, the LH access will be less than or equal to the RH 
access, and the trap-to-user and copy-on-write bits will be 
set in the LH if they were found set at any level. Bits 5 
and 10 always refer to the last pointer (i.e. first 
non-indirect pointer) encountered. 

Generates illegal instruction PSI on error conditions below. 

RPACS ERROR MNEMONICS: 



DESXl: illegal value for designator 

DESX2: terminal not available to this job 

DESX3: no name for this JFN 

DESX4: terminal designator or string pointer not legal 

DESX5: file not open 

DESX7: file must be on disk 

FRKHXls illegal fork handle 

FRKHX3: cannot reference multiple forks 
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SPACS JSYS 60 

Sets the accessibility of a page 

ACCEPTS IN 1: left half: fork/file designator 

right half: a page number in the file 

2: access information 

Affects only the map word directly indicated, 
i.e. no indirect pointers are followed. 

B2 permit read access 

B3 permit write access 

B4 permit execute access 

B8 trap to user (PSI channel 21) on any access 

B9 copy on write 

SPACS 

RETURNS +1: always 

When modifying a fork page, SPACS will allow no greater 
access than could be obtained with PMAP. Open file 
protection is applied to SPACS operations involving file 
pointers. 

SPACS will never allow any bits to be set in a page which 
does not already exist. 

Generates illegal instruction PSI on error conditions below. 

SPACS ERROR MNEMONICS: 

DESXl: illegal value for designator 

DESX2: terminal not available to this job 

DESX3: no name for this JFN 

DESX4: terminal designator or string pointer not legal 

DESX5: file not open 

DESX7: file must be on disk 

SPACXl: attempt to gain illegal access to a page 

FRKHXl: illegal fork handle 

FRKHX2: cannot manipulate a superior fork 

FRKHX3: cannot reference multiple forks 
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RMAP JSYS 61 

Acquires a handle on a page in a fork 

ACCEPTS. IN 1: left half: a fork handle 

right half: a page number in that fork 

RMAP 

RETURNS +1: with a handle on the page in 1 
B0-B17, a fork/file designator 
B18-B35, a page number 

Returns in 2: Access information as follows 

B2 read access allowed 

B3 write access allowed 

B4 execute access allowed 

B5 page exists 

B8 trap-to-user on any access 

B9 copy-on-write 

If the argument to RMAP specifies a page in a fork (not a 
file), and that page is private, then the page will be moved 
to the job's PMF and will then be shared between the fork 
and the file. The identifier returned in this case will 
contain the JFN of the job's PMF and the page number in that 
file that was assigned. 

NOTE: To just find out whether a page exists, use 
RPACS which will tell you without changing the state of any 
type of page. 

If the specified page is shared with a file but no JFN is 
assigned to the file (e.g. because it was released with the 
B5 option of CLZFF) , -1 is returned in 1 and in 2. 

Generates illeaal instruction PSI on error conditions below. 

RMAP ERROR MNEMONICS: 

FRKHXl: illeaal fork handle 
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SACTF 



JSYS 62 



Sets account number or string to which existing file is 
being charged. 

ACCEPTS IN 1: JFN 

2: account number in bits 3-35 if bits 0-2 = 5 
else a string pointer to an account string in 
the address space of caller. If the normal 
terminating null byte is not seen, the string 
is terminated after the 8th full word is 
processed. 

SACTF 

RETURNS +1: illegal, error # in 1 

+2: successful, updated string pointer in 2 

Account must be numeric if LOGIN directory takes numeric 
accounts only, regardless of directory JFN is in, unless the 
process has the WHEEL or OPERATOR special capability 
enabled. 



SACTF ERROR MNEMONICS: 



DESXl; illegal value for designator 

DESX2: terminal not available to this job 

DESX3: no name for this JFN 

DESX4: terminal designator or string pointer not legal 

SACTXl: file is on non-multiple directory device 

SACTX2: no room in JSB for manipulating string 

SACTX3: alphanumeric accounts not allowed 

in this directory 

SACTX4: access not allowed 
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FILE DESCRIPTOR BLOCK FORMAT 



The field "CHANGE" lists who can change particular parameters 
w=*wheel, op=operator, or=anyone with ownership rights, 
wa=anyone who has write access to the file, 
if blank, no one can change the field with CHFDB JSYS. 



N NAME NWORDS CHANGE 

F none I 

1 FDBCTL 1 

or 
w+op 



w+op+or 
w+op 









w+op+or 


2 


FDBEXT 






3 
4 


FDBADR 
FDBPRT 


1 
1 




5 
6 


FDBCRE 
FDBUSE 


1 
1 


w+op+or 
w+op 
w+op 


7 


FDBVER 


1 




10 


FDBACT 


1 




11 


FDBBYV 


1 


or 
or+wa 


12 
13 


FDBSIZ 
FDBCRV 


1 
1 


wa 
w+op 


14 
15 
16 

17 
24 


FDBWRT 
FDBREF 
FDBCNT 

FDBBCK 
FDBUSW 


1 
1 
1 

5 
1 


w+op 
w+op 
w+op 
w+op 

or 



DESCRIPTION 
the header 
LHz control bits 
B0, FDBTMP file is temporary 
Bl, FDBPRM file is permanent 
B2, FDBNEX no extension for 
this FDB yet, file does not 
really exist 

B3, FDBDEL file is deleted 
B4, FDBNXF file does not exist 
(first write not complete) 
B5, FDBLNG long file 
B6, FDBSHT compressed page table 
B17, FDBEPII ephemeral file 
RH: location of file name block 
LH: location of extension block 
RH: pointer to other extensions 
the file address & class field 
file protection word 
LH: 500000 

RH: file protection bits 
creation date and time of version 1 
LH: last write directory number 
RH: use count (+1 for each 
indirect pointer 
and saved environment) 
LH: version number 
RH: pointer to next version 
account information for charging 
+ for location of string block 
- for number 

LH: number of versions to 
retain in B0-B5 
byte size B6-B11 
RH: number of pages in file 
byte count which would address EOF 
creation date and time 
of this version 
date and time of last write 
date and time of last read 
LH: count of writes 
RH: count of reads 
words for backup system 
user settable word 
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Gets a file descriptor block 

ACCEPTS IN 1: JFN 

2: XV7D number of words to read, displacement 
in FDB of first word to read. 

Example: XWD 25 ,0 

would read the whole block 

3: starting location in address space of caller 
for reading in descriptor block 

GTFDB 

RETURNS +1: always 

Generates Illegal Instruction PSI on error conditions below. 

GTFDB ERROR MNEMONICS: 

GFDBXl: displacement illegal 

GFDBX2: number of words illegal 

GFDBX3: list access not allowed 

DESXl: illegal value for designator 

DESX3: no name for this JFN 

DESX4: terminal designator or string pointer not legal 
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CHFDB JSYS 64 
Changes selected words in a file descriptor block 

ACCEPTS IN 1:LH: displacement into FDB indicating word 

to be changed 
RH: JFN 

2: mask indicating bits to be changed 

3: changed bits 

CHFDB 
RETURNS +1: always 
Generates Illegal Instruction PSI on error conditions below 

CHFDB ERROR MNEMONICS: 

CFDBXl: displacement illegal 

CFDBX2: illegal to change specified bits 

CFDBX3: must be operator or wheel to change specified 

bits 
CFDBX4: illegal to set specif ed bits to value in 3 
DESXl: illegal value for designator 
DESX3: no name for this JFN 
DESX4: terminal designator or string pointer not 

legal 
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DELDF JSYS 6 7 

Reclaims space (expunges) files which have been marked for 
deletion on DSK: with DELF 

ACCEPTS IN 1: directory number 

DELDF 

RETURNS +1: ALWAYS 

Directory number given must be that of connected directory 
unless process has WHEEL special capability enabled. 
If call is in any way illegal, DELDF does no tiling. 
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DUMP I JSYS 6 5 

Reads into core in an unbuffered data mode (mode 17) 

ACCEPTS IN 1: JPN 

2: pointer to a command list in core 

DUMP I 

RETURNS +1: unsuccessful, error # in 1 

pointer to offending command in 2 

+2: successful, pointer in 2 updated to point to 
last command 

COMMAND LIST FORMAT: 

Three types of entries may occur in the command list. 

a. I0V7D n, loc - Causes n words from loc through loc+n-1 
to be transmitted. The next command is obtained from 
the location following the IOWD. The assembler 
pseudo-op IOV T I) generates XWD -n, loc-1. 

b. XWD 0, y - Causes the next command to be taken from 
location y. Referred to as a GOTO word. Up to three 
consecutive GOTO words are allowed in the command list. 
After three consecutive GOTO words, an I/O instruction 
must be written. 

c. - Terminates the command list. 

DUMPI ERROR MNEMONICS: 

DUMPXl: command error 

DUMPX2: data mode not 17 for this JFN 

DUMPX3: address error (too big or crosses 

end of memory) 
DUMPX4: access error (cannot read or write 

data in memory) 
DESXl: illegal value for designator 
DESX2: terminal not available to this job 
DESX3: no name for this JFN 
DESX4: terminal designator or string pointer not 

leaal 
DESX5: not open 
IOXl: illegal read 
10X4: end of file 
10X5: data error 
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DUMPO JSYS 66 

Writes from core using an unbuffered data mode (mode 17) . 

ACCEPTS IN 1: JFN 

2: pointer to a command list in core 
(see DUMPI) 

DUMPO 

RETURNS +1: unsuccessful, error # in 1 

pointer to offending command in 2 

+2: successful, pointer in 2 updated to point to 
last command 

DUMPO ERROR MNEMONICS: 



DUMPXl: 
DUMP X 2 : 
DUMPX3: 

DUMPX4 : 

DESXl: 
DESX2: 
DESX3: 
DESX4: 

DESX5: 

10X2: 

10X5: 



command error 

data mode not 17 for this JFN 

address error (too big or crosses 

end of memory) 

access error (cannot read or write 

data in memory) 

illegal value for designator 

terminal not available to this job 

no name for this JFN 

terminal designator or string pointer not 

legal 

not open 

illegal write 

data error 
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MTOPR JSYS 77 
Performs device dependent control functions. 
ACCEPTS IN 1: JFN 

2: operation wanted (see table below) 

MTOPR 
RETURNS +1: successful 

Generates Illegal Instruction PSI on error conditions below 
For magnetic tape (MTA:) , operations are: 

I rewind 

3 write eof 

6 forward space one record 

7 backward space one record 

10 space to end of tape 

II rewind and unload 

13 write 3 inches of blank tape 

16 forward space one file 

17 backward space one file 

For the ARPA network (NET:), operations are: 

20 Accept connection. Causes RFC to be sent. 

21 Dump buffer. Sends all currently buffered bytes. 

22 Send INS/INR 

23 not used 

24 Assign interrupt 

AC3 0-5 INS/INR PSI channel 

(> 36 means don't interrupt) 
6-11 not used 
12-17 State change PSI channel 
18-35 Reserved for expansion 

For DECTAPE (DTA:), operations are: 

1 Rewind 

11 Rewind and flap tane 

30 Use block # in AC 3 for next DUMPI/O. 

All other operations are NOPs except that all MTOPRs 
clear error and end-of-file flags. 
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MTOPR ERROR MNEMONICS: 

DESXl: illegal value for designator 

DESX2: terminal not available to this job 

DESX3: no name for this JFN 

DESX4: terminal designator or string pointer not legal 

DESX5: not open 



ATPTY JSYS 274 

Attaches a pair of network connections to a network terminal 

ACCEPTS in 1: JFN of opened but unused receive connection 
2: JFN of opened but unused send connection 



RETURN* 



ATPTY 

+1: unsuccessful, error # in 1 

+2: successful, terminal designator in 1 



ATPTY ERROR MNEMONICS: 

ATPXl: invalid receive JFN 

ATPX2: JFN in 1 is not receive connection 

ATPX3: receive JFN not opened 

ATPX4: receive JFN not network connection 

ATPX5: receive JFN has been used 

ATPX6: receive connection refused 

ATPX7: invalid send JFN 

ATPX8: JFN in 2 is not send connection 

ATPX9: send JFN not opened 

ATPX10: send JFN not network connection 

ATPXll: send JFN has been used 

ATPX12: send connection refused 

IVTPX13: NO PTY's available 
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GPJFN JSYS 206 

Get £rimary JFN's 

ACCEPTS IN 1: fork handle 

GPJFN 

RETURNS +1: always 

2: LH: primary input JFN 
RH : primary output JFN 

Gives illegal instruction PSI on the following errors: 

FRKHXl: illeaal fork handle 

FRKHX2: cannot reference superior fork 

FRKHX3: cannot reference multiple forks 



Primary I/O - If the primary input designator is not exactly 
the same as the primary output designator (see SPJFN, 
GPJFN) , each character of input will be "echoed" on the 
output . 



SPJFN JSYS 2 07 

Set £rimary JFN 's 

ACCEPTS IN 1: fork handle 

2 : LH : primary input JFN 
RH : primary output JFN 

SPJFN 
RETURNS +1: always 

JFN cannot be 10 ^ or 101: either of these will cause the 
specified fork to get an error on any primary I/O 
operations . 

Gives illegal instruction PSI on the following errors: 

FRKHXl: illegal fork handle 

FRKHX2: cannot reference superior fork 

FRKHX3: cannot reference multiple forks 
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for expansion of the network section, pages 
72 , 73 , 74 , 75, 76 , 77, 78 , 79 , 80. 
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ESTABLISHING AND BREAKING NETWORK CONNEXIONS 

User programs that use the ARPANET do so through the 
TENEX file system. Establishing a network connection from 
TENEX involves two steps : 

obtaining a JFN for a "file" corresponding to the 
desired connection (via the GTJFN JSYS) and; 

transmitting a "request for connection" (RFC) to 
the appropriate remote Host (via the OPENF and/or 
MTOPR JSYS'S) 



A network connection has the following characteristics: 
Two ends : 

Each end of a connection is called a socket . Socket 
names are 32 bit numbers. The end of the connection in 
the local Host computer is called the local socket and 
the end in the remote Host, the foreign socket. The 
remote computer is called the foreign Host. Only one 
connection with the same pairs of ends may be in 
existence at a given time. 

A byte size: 

Data transmission over the network occurs in units of 
bytes. The byte size for a connection is fixed when 
the connection is established. For TENEX, lack of 
agreement in byte size with the foreign host will cause 
the connection attempt to fail. 

A direction: 

Information may flow in only one direction over a 
connection. 

In TENEX, file names corresponding to network 
connections are of the form: 

NET: [LS[#]]. [FH-FS] [;T] 

where [ ] is used to indicate optional presence, LS 
specifies a local socket, FH a foreign host and FS a foreign 
socket. 

Device field: 

NET: indicates that the "file" corresponds to a network 
connection. 
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NETWORK 



Name field: 

LS identifies a local socket. It should be an octal 
number less than 400 (8 bits) unless "#" is present in which 
case it should be less than 40000000000 (32 bits). When LS 
is omitted, its default value is taken to be JFN*10 (octal), 
where JFN is the job file number returned by GTJFN. The 
actual (absolute) local socket corresponding to LS is 
determined as follows: 

If "#" is used, the local socket is LS. Use of "#" 
requires wheel or operator capability; 

If " ;T" is used, the local socket is said to be "job 

relative" and is guaranteed to be unique to the user's 

job. In the current implementation, the local socket 
number is: 

( 303240 + JOB ) LS 

high 17 bits low 15 bits 

where JOB is the user's TENEX job number. 

If ";T" is not used, the local socket is said to be 
"directory" or "user" relative and is guaranteed to be 
unique to the connected directory. In the current 
implementation, the local socket number is: 

DIR LS 

high 17 bits low 15 bits 

where DIR is the number of the connected directory. 

Extension Field: 

FH and FS identify the foreign Host and socket. FII 
should be either the official ARPANET name (or nickname) for 
the foreign Host or the network address (in octal) of the 
foreign Host. A table of Host names and addresses appears 
in the manual "ARPANET TENEX". FS specifies the (absolute) 
foreign socket and should be an octal number less than 
40000000000 (32 bits). If the extension is null, the 
subsequent OPENF causes the connection to be placed in the 
so-called "listening" state. 
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Examples : 

NET:1#. specifies the local logger socket. 

NET: 10. UTAH- 10-1 specifies a directory relative 

connection to the UTAH logger 
socket. 

NET: 11. 106-400346 ;T specifies a job relative 

connection to socket 400346 at 
host number 106 (octal) , which is 
MIT-DMCG. 

The OPEfJF JSYS is used to open network connections. 



Connection byte sizes may be 8, 32 or 36. Connections 
opened for reading are receive connections and those opened 
for writing are send connections. If non-zero, bits 12-17 
of AC2 specify that the buffer for the connection is to be 
smaller than the system default and of the specified size in 
words. 



There are four legal data modes for network "files" which 
independently specify strategies for connection 
establishment and data transmission. The modes are: 

Normal mode. Wait until a matching RFC or CLS is 
received from the remote Host before returning from 
OPENF to the user program. For data transmission, send 
bytes as soon as possible. 

5 Buffered send mode. Wait (as above) before 
returning to the user program. For transmission, data 
is to be held in local system buffers until an amount 
appropriate for efficient network utilization 
accumulates or until the user program explicitly 
requests transmission (via the MTOPR JSYS described 
below) . 

6 Immediate return mode. Return from the OPENF 
immediately without waiting for matching RFC or CLS 
from the foreign host. The connection must be "open" 
before data transfer can be successfully attempted. 
Methods for determining the "state" of a connection are 
described below. 

7 Buffered send and immediate return. This mode 
combines modes 5 and 6. 
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For a network connection OPENF may fail if: 

The foreign Host is dead (OPNX20) ; 

The connection already exists (0PNX9) ; 

The connection attempt is rejected by the foreign host 
(OPNX21) ; 

The local system's network connection table has 
insufficient space for a new connection (OPNX10). 

The specified byte size does not match thcit of the RFC 
specification received (for receive connections only) 
(OPNX22) 



A connection whose corresponding file name has a null 
extension is placed in a listening state by OPENF. In the 
listening state it is receptive to RFC's from any socket at 
any site. Arrival of such an RFC results in a change of 
connection state (which may cause an interrupt; see MTOPR) , 
at which point the user program may choose to accept the 
connection attempt by causing a matching RFC to be sent (via 
a data transfer operation, e.g. BIN, BOUT, or via the MTOPR 
JSYS) or it may choose to reject it by issuing a CLS (via 
CLOSF) . To make this decision, GDSTS may be used to 
determine the remote host and socket numbers. 

Network connections may be closed by any of the JSYS'S 
that close files (CLOSF, RESET, etc.). An option available 
when closing a connection via CLOSF is whether to wait until 
the connection is "completely" closed. When bit 1 of ACl is 
set, CLOSF does not return to the user program until a 
matching CLS has arrived from the foreign Host. This option 
is useful when it is desired to immediately reopen the 
connection; if the connection is not completely closed when 
the next attempt to open it is made, the attempt will fail. 
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DATA T RANSFER OVER NETWORK C ONNECTIONS 

The standard TENEX file data transfer JSYS's, BOUT, 
SOUT, BIN, and SIN, are used to send and receive data over 
network connections. 

BOUT and SOUT cause data to be moved from the user's 
address space to TENEX system network buffers for 
transmission. For connections opened in unbuffered send 
mode (see above) , the data is sent out into the network as 
soon as possible (consistent with Host-Host flow control 
restrictions) . Use of unbuffered send connections can 
result in a large number of small network messages. More 
efficient use of the network can be made by using 
connections opened in buffered send mode for which TENEX 
collects the data into larger network messages for 
transmission. TENEX does this by keeping the data" within 
system buffers until "enough" accumulates to allow for 
efficient network utilization before sending it to the 
remote Host. The user program can force TENEX to transmit 
the accumulated data using the MTOPR JSYS. 

If the system buffers for a connection are full (and 
HOST-HOST flow control restrictions prevent TENEX from 
transmitting the data), BOUT and SOUT will "hang". This can 
happen if the remote process reading from the connection 
removes data more slowly than it is being sent. Similarly, 
if the system buffers for a connection are empty, BIN and 
SIN will "hang". To avoid hanging on input, the SIDE JSYS 
can be used to test the condition of the buffers before 
attempting the data transfer. 

It sometimes happens that connections that have been 
established are unexpectedly broken; e.g. the remote Host 
crashes or the remote process closes the connection without 
warning. An attempt to send over a connection that has been 
closed results in an 10 Data Error PSI. Attempting to read 
from a connection that has been closed delivers null bytes 
and results in an End of File PSI. 
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OBTAINING STATUS INFORMATION 

Information about a network connection may be obtained 
via the GDSTS JSYS. For a network file the following values 
are returned in the designated accumulator. 

2: B0-B3; Contains connection state 

3; Contains the foreign host number 

4: Contains the foreign socket number 





The 





DEAD 


1 


CLZD 


2 


PNDG 


3 


LSNG 



RFCR 



5 CLW2 

6 RFCS 

7 OPND 
10 CLSI7 



states a connection may be in are: 

Not possible if an OPENF has been done for the 
JFN. 

Cannot be returned by GDSTS. 

Cannot be returned by GDSTS. 

The name corresponding to the JFN had a null 
extension. An OPENF has been done and no attempt 
has been made to connect to the local socket. 

The name corresponding to the JFN had a null 
extension. An OPENF has been done and a request 
for connection has been received for the local 
socket from some foreign host. 

Cannot be returned by GDSTS. 

An OPENF has been done specifying a foreign 
host-socket and a response has not yet arrived 
from the foreign host. 



11 DATW 

12 RFNl 



The connection is fully open 
transmission may occur. 



and 



data 



For a connection with a JFN, this state means 
that a time out has occurred for a connection 
which was in the RFCS state and for which the 
foreign Host has not yet responded with the 
proper close commands. 

Cannot be returned by GDSTS 

Cannot be returned by GDSTS 
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13 CLZW 



14 RFN2 



The foreign Host has 
connection be closed. 



requested that the 



This is a transitory state which may occur before 
CLZW, if there was an outstanding RFNM when the 
foreign host requested the connection to be 
closed. 



16 FREE Cannot be returned by GDSTS. 



The Pseudo-Interrupt system can be set up to generate 
an interrupt when the state of a specified connection 
changes or an INS or INR is received. To do that the MTOPR 
JSYS (described below) is used to specify a connection and 
PSI channels. 
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INR/INS Interrupts and the MTOPR JSYS 

The ARPANET Host-Host protocol includes a mechanism for 
transmitting "interrupt" signals over connections. It 
provides for "interrupt by sender" (INS) and "interrupt by 
receiver" (INR) . A connection interrupt signal bypasses the 
Host-Host flow control restrictions for data on the 
connection and therefore will get through to the remote host 
even when the connection data buffers are full. The INS/INR 
mechanism is used in some server TELNET implementations for 
"attention" signalling. The Host-Host protocol interrupt 
mechanism is accessible to TENEX user programs via the MTOPR 
JSYS. 

The MTOPR JSYS is used to perform a variety of device 
dependent control functions. For the "network device" 
(NET:) MTOPR may be used to force transmission (for buffered 
send connections) , to send an RFC, to send INS/INR signals 
and to set up the PS I system to handle change of state and 
INR/INS interrupts. 

MTOPR functions for the network files are; 

20 Accept connections. Causes an RFC to be 

sent (only valid if connection in RFCR state) 

21 Dump buffer. Sends all currently 

buffered bytes 

22 Send INS/INR 

24 Assign Interrupt 

AC3: B0-B5 INS/INR PSI channel 

(> 36 means don't interrupt) 
Note that the indicated channel 
and the rest of the PSI 
system must also be initialized 
and enabled and activated. 
B6-B11 not used 

B12-B17 State change PSI channel 
B18-B35 Reserved for expansion 
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MISCELLANEOUS 

TENEX does not make an entry in its network connection 
tables for a connection until OPENF is performed. The least 
significant bit of both LS and FS in a network file name is 
ignored until the OPENF, at which time the correct low order 
bit, as required by the Host-Host protocol, is inserted. 
For "send" sockets the least significant bit is set to 1, 
for "receive" sockets, to 0. 

CVSKT JSYS can be used to determine the absolute local 
socket number corresponding to a JFN. 



CVSKT JSYS 2 75 

Converts a local network socket number to absolute form. 

ACCEPTS IN 1: JFN 

CVSKT 

RETURNS +1: unsuccessful, error # in 1 

+2: successful, absolute local socket number in 2. 

CVSKT ERROR MNEMONICS: 

CVSKXl: Bad JFN 

CVSKX2: name field associated with JFN does 

not decode into a reasonable local 

socket specification 



A list of host names and numbers will be found in the new 
manual "ARPANET TENEX". 
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CVHST 276 

Converts a HoST number to primary name. 

ACCEPTS IN 1: TENEX destination designator where ASCIZ 
string is to be written 

2: host number 

CVHST 

RETURNS +1: failure (no string for that number) 

+2; successful, with host name written, 

LHOSTN is a single entry system table which may be read with 
the SYSGT JSYS. It contains the host number corresponding 
to the local TENEX. 



FLHST JSYS 277 

FLush HoST 

ACCEPTS IN 1: host number 

FLHST 

RETURNS +1: always 

Resets the NCP tables which contain status information about 
the indicated host, and sends host-to-host protocol RST 
(reset) command to that host. 

Has no effect unless the user is an ENABLE* ed WHEEL or 
OPERATOR. 
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Section 2 Index 
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ATPTY 70 

BIN 49, 84, 85 

BKJFN 41 
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CNDIR 43 
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DELF . . 29 

DELNF 30 

DIRST 40 

DUMP I . . 67 
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End of File Pointer 7 

ESOUT 48 
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File Access Protection .... 5 
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File Handles 1 

File Names ...3 

File References in TENEX ... 1 

FLHST 9 

FS 82 

GACTF 38 

GDSTS 86 
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GPJFN 71 

GTFDB 64 
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Host-Host 85, 88 
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Input/output errors . • . . • 8 
INR/INS 88 

JFN status word • 28 

JFNS 32 

LHOSTN 90 

LS 82 

Methods of Data Transfer . . . 7 

MTOPR 69, 81, 83, 84, 88 

NET: 81, 88 

Network 70, 81, 89 

Not implemented for DECtape files 41 
NOT IMPLEMENTED YET 22, 35 

OPENF 22, 81, 83, 84 

OPERATOR special capability . 62, 63, 65 

PBIN 46 

PBOUT 46 

PMAP 7, 55 

Primary input .46 

Primary Input and Output Files 7 
Primary output ........46, 47 

PSI 88 

PSOUT 47 

RESET 27, 84 

RFBSZ 44 

RFC 81, 83, 88 

RFPTR 42 

RIN 52 

RLJFN 26 

RMAP 61 

RNAMF 36 

ROUT 54 

RPACS 59 

SACTF 62 

Sample Program 2 

SFBSZ 44 

SFPTR 7, 31 

SIN 51, 85 

SIZEF 37 

Socket 81 

SOUT 52, 85 

SPACS 60 

SPJFN 71 

STDIR 39 

STSTS 29 

SWJFN 45 
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TELNET 88 

WHEEL special capability • • • 8, 62 , 6 3 , 65 , 66 
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JSYS's FOR OBTAINING INFORMATION 



INTRODUCTION 



These JSYS's are used to obtain information from the 
system, such as the time of day, resources used by the 
current job, error conditions, and the contents of system 
tables . 

Several of these calls return time values (intervals, 
accumulated times, etc.). These are all integer numbers in 
units of 1/N seconds, where N is provided by the TIME JSYS . 
The system interval clock is in milliseconds, and the 
current value of N is therefore 1000. 



GJINF JSYS 13 

Gets job specific information 

GJINF 

RETURNS +1: always with accumulators listed below 
containing: 

1 directory # under which job is logged in 

2 directory # to which job is connected 

3 tss job number 

4 terminal number attached to job or -1 if job 

is detached 
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TIME JSYS 14 

Gives time since system was restarted last, 

TIME 

RETURNS +1: with time right justified in 1, 

divisor to convert to seconds in 2 



This is a monotonically increasing number (when the system 
is running) independent of resets of the time and date and 
should be used for timing execution of programs, and for 
getting actual time and date. 



RUNTM JSYS 15 
Gives runtime of one process or the whole job 
ACCEPTS IN 1: a fork handle (-5 means whole job) 

RUNTM 

RETURNS +1: with runtime right justified in 1, 
divisor to convert to seconds in 2, 
console time in 3 (apply divisor in 2 to get 
seconds) 

Generates illegal instruction pseudo-interrupt 
on error conditions below. 

RUNTM ERROR MNEMONICS: 

FRKHXl: illegal fork handle 

RUNTXl: fork handles -3,-4 are illegal 
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JOBTM JSYS 316 

Gives runtime in milliseconds at the current job time. 

JOBTM 

RETURNS +1: always, with the runtime in milliseconds of 
the current job in 1. 



SWTCH JSYS 320 
Gives the 36 data switch settings 

SWTCH 



RETURNS +1: always , with the 36 data switch 
^ settings in 1 
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GTAD J.SYS 227 

Gets current time and date in system internal format (see 
introduction) • 

GTAD 

RETURNS +1: with date in LH 1, 

time in seconds since midnite in RH 1, 

-1 is returned in 1 if the system does not 
have the time and date. 



STAD JSYS 226 
Sets system time and date 
ACCEPTS IN 1: date and time 

STAD 
RETURNS +1: unsuccessful, error code in 1 
+2: successful 

Requires WHEEL or OPERATOR special capability if system 
already has date and time. 

STAD ERROR MNEMONICS: 

STADXl: date and time already in system and caller 

does not have WHEEL or OPERATOR 

capability enabled 
STADX2: impossible values for date and time 
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The ensuing two JSYS's, ERSTR and GETER, translate 
error numbers to error strings and retrieve error numbers. 
A file called ERROR. MNEMONICS in the SYSTEM directory in 
TENEX contains the error message strings associated with 
system error numbers. The error message strings are ASCII 
strings terminated by @, and they have a simple structure 
which permits them to type out the parameters of the error. 
To facilitate this, five cells are set aside in the PSB for 
storing error parameters. These parameters include such 
things as the location of an offending OP-CODE, an illegal 
character presented in a file name, etc. The error message 
string has a simple command language which enables one to 
specify various modes of typeout of particular error 
parameters . 

A parameter typeout command is denoted by a "% M 
character followed by one or more commands terminated by a 
"%" character. The character "%" may not be used as a 
character in the text of error message strings. The 
character wNkH is also illegal since it is used as the 
terminator to ASCII (see example) . 

The following commands are defined after %: 

The n stands for the particular word in the PSB to be used 
as the parameter. 

nA types parameter as ASCII (null terminates) 

nO types parameter in octal 

nD types parameter in decimal 

nH types parameter in octal half words separated by 

comma 
nF types parameter in floating point free format 

output 
mE is a recursive pointer to another error message (m 

is the error number) 
L means type out enough information to locate this 

process in the fork structure. A typeout of the 

form 1.2.4.2 will result which is a list of the 

relative fork handles by which one could reference 

this fork starting at the top level. 
nN means interpret contents of word n in PSB as a JFN 

which means to fill in the file name associated 

with this JFN 
@nZ (where Z stands for any of the commands above) The 

@ means use the location in this fork pointed to by 

the cell in the PSB 

An example of an error string would be the illegal 
instruction error string: 

ASCII \ Attempt to execute the illegal instruction %0H% at 
location %10% of fork %20%@\ 
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ERSTR JSYS 11 

JSYS to translate an error # to a string 

ACCEPTS IN 1: TENEX destination designator 

2: LH: a fork designator 

RH: an error number (-1 means the most recent 
error) 

3: LH: a negative count of maximum number of 
bytes in string to be transferred, or for 
no limit 
RH: 

Bl8 off means expand parameter typeout 
commands , on means do not expand 
B19 off means use 5 words in PSB of 
designated fork, on means use accumulators 
4-10 
4-10: used optionally, see 3 

ERSTR 

RETURNS +1: undefined error number 

+2: string size out of bounds or illegal TENEX 
destination designator or illegal fork 
handle 

+3: successful 



NOTE: The ESOUT JSYS (Section 2) should be used to report 
errors in consistent fashion. 
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GETER JSYS 12 

JSYS to get the most recent error condition encountered in a 
fork 

ACCEPTS IN 1: fork designator 

GETER 

RETURNS +1: always, with most recent error condition in RH 
of 2 (always) and fork designator in LH of 2, 
and with 5 parameters from PSB in 4-10 

The most recent error condition is always saved in PSB. 

NOTE: GETER differs from most JSYS's in that it modifies 
accumulators higher than 4. 



SETNM JSYS 210 

Declares name of subsystem being used by job, i.e., sets 
name. 

ACCEPTS IN 1: SIXBIT name used to identify 
program or subsystem 

SETNM 

RETURNS +1: always 

Subsystem usage statistics are accumulated in system tables 
SNAMES, STIMES, and SPFLTS (defined elsewhere in this 
section). To make this possible, SETNM must be executed by 
each job whenever the subsystem is changed. In all usual 
cases, the EXEC handles this. The argument to SETNM should 
be: for subsystems (programs from directory<SUBSYS> or 
<SYSTEM>) , the file name, truncated to six characters and 
converted to SIXBIT; for all other programs, "(PRIV)". 

NOTE: Each program named by a SETNM takes a slot in the 
system statistics tables. When all slots are used, the 
names will be set to .OTHER regardless of the contents of 
AC 1. 

Please do not execute SETNM unless you need statistics for 
the program. 
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GETNM JSYS 177 

Gets name of subsystem being used by job. (Previously 
declared by SETNM) 

GETNM 

RETURNS +1: always, with 

SIXBIT name of program in 1 



GTRPI JSYS 172 
Get trap information for a specific fork. 
ACCEPTS IN 1: a fork handle 

GTRPI 
RETURNS +1: always, with: 

1. number of pager traps for designated fork 

2. number of page faults for designated fork 

3. time spent in page routines by 
designated fork 

GTRPI ERROR MNEMONICS: 

FRKHXl: illegal fork handle 

FRKHX2: cannot be used to manipulate a superior fork 

FRKHX3: cannot be used to manipulate multiple forks 



GTDAL JSYS 305 
Gets the disk allocation of a specified directory. 

ACCEPTS in 1: desired directory (nonzero value not 

implemented yet) 
0=> currently connected directory. 

GTDAL 

RETURNS +1: always, with allocated number of pages for the 
specified directory in 1, and number of pages 
currently used in that directory in 2. 
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System Tables 

The contents of several system tables are available to 
programs, for such purposes as generating status reports and 
collecting system performance statistics. Each table is 
identified by a fixed name of up to six characters, and 
consists of a variable number of 1-word entries. Entry -1 
in each table is the negative of the number of data entries 
in the table; the data entries are identified by an index 
which runs up from 0. Two JSYS's exist for accessing 
tables: the first, SYSGT, takes a table name and returns the 
table length, its entry 0, and a number identifying the 
table for use with the other JSYS , GETAB, to obtain 
additional entries from the table. 

Where numeric table indices are given, they are octal: 

name index contents 



JOBTTY 



JOBRT 



TSS JOB # LH: controlling terminal line #, 

-1 if none (i.e., job is detached) 
RH: top fork in job 

TSS JOB # CPU time used by job, 

negative if no such job 



TICKPS one-word table giving divisor to convert JOBRT 
entries to seconds 



JOBDIR TSS JOB # 



RH: logged in directory number, 

if not logged in 
LH: connected directory number 



TTYJOB line number LH: positive TSS job # for which this 

is controlling terminal, or 
-1 for unassigned line, or 
-2 for line in process of being 
assigned, or 

400000+TSS job # to which this 
line is assigned. 
RH: -1 if no fork is waiting for input 
from this terminal, 
other than -1 if some fork is 
waiting for input. 

NCPGS one-word table containing number of pages of real 
(physical) user core available in system 
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Tables DEVNAM, DEVCHR, and DEVUNT are parallel; their 
indices are significant only in that the same entry in each 
table pertains to the same device. 

DEVNAM SIXBIT device name, e.g., "DTAl" 

DEVCHR device characteristics word, as documented under 
DEVOIR JSYS in section 4, except that B5 is not 
meaningful. 

DEVUNT RH: unit number, or -1 if device has no units 
(e.g., DSK:) 

LH: TSS job # to which device is assigned (with 
ASND) , or -1 if not assigned 

DSKERR information on disk errors: 

number of recoverable disk errors 
1,2,3 command words for last recoverable disk 
error 

4 error bits for last recoverable disk error 

5 number of irrecoverable disk errors 

6-11 3 command words and error bits for last 
irrecoverable disk error 



DRMERR drum error information 

number of recoverable errors 
1,2,3 2 command words and error bits 
recoverable error 



for last 



SYSVER contains an ASCII string identifying the system 
name and version, 
e.g., BRN-TENEX 1.31.23 

VERN.UM One-word table containing the system version as a 
number, e.g. , the decimal number 13123. 

PGSTAT Pager trap information for this process 

count of pager traps 

1 count of page faults 

2 time spent in trap routines 
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jobs (in ticks, see 
runnable jobs 



SYSTAT monitor statistics 

time with no runnable 
TICKPS) 

1 waiting time with 1 or more 

(waiting for page swapping) 

2 time spent in core management 

3 time spent processing pager traps 

4 number of drum reads 

5 number of drum writes 

6 number of disk reads 

7 number of disk writes 

10 number of terminal wakeups 

11 number of terminal interrupts 

12 time integral of number of jobs in balance 
set 

13 time integral of runnable jobs 

14 1 min. load average (floating point format) 

15 5 min, load average (floating point format) 

16 15 min, load average (floating point format) 

17 sum of process disc wait 

20 sum of process drum wait 

21 total number terminal input characters 

22 total number terminal output characters 
2 3 total number of garbage collections 

24 integral postpurge time 

25 count of forced balance set removals 

26 sum process wait time 

27 time of pending system shut down 

(TENEX internal time format) 
30 time system scheduled back up 

(TENEX internal time format) 



Note: This table is subject to change (usually 
additions) as measuring routines are added to 
the system. Consult monitor symbolic listing 
SCHED.MAC for most recent description of this 
table. 



QTIMES 0-4 



Accumulated runtime of jobs 
scheduler queues 



on 



the 
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JOBNAM 



TSS JOB # 



LH: unspecified 
RII: index into the tables SNAMES, 
STIMES and SPFLTS for the subsystem 
being used by this job (determined by 
the last SETNM JSYS executed by job) 

The following 5 tables are parallel: corresponding entries 
in each table contain information about the same subsystem. 
The subsystem being run by a specific job may be determined 
from SNAMES , using an index obtained from table JOBNAM 
(above) • 

SNAMES SIXBIT name of subsystem, or if this entry 
unused in this and the following 2 tables, 

STIMES Total runtime of subsystem 

SPFLTS Total number of page faults of subsystem. 

SWAKES Totals relating to terminal usage, changed often. 
SBLKTM See code. 



ENTFLG 

DBUGSW 

SYMTAB 
LOGDES 



One-word table: non zero if users may log in. 
zero, TENEX is not available. 



If 



has DBUGSW as its first entry and 
second entry. 



DCHKSW as its 



points to the table of SIXBIT GETAB names 

is two words long, the first being LOGDES, the TTY 
for login/logout messages and the second being 
JB0TT, the designator of the terminal for error 
comments from SYS JOB, BUGCIIK'S, and the NCP. 

The following words and tables relate to the ARPA Network 
interface, and will not be recognized if the system does not 
have an IMP connection. 



NETRDY 



IMPHRT 



HSTNAM 



Network operational status, 2 words 

= -1 if IMP operating normally 

1 = if network turned off, non-0 if on 

Table of bits, one for each possible host. 
Bit N is 1 if on NCP control message has been 
received for host N. The bit for host N is 
in bit N mod 36 of word N/36. 



gives names of hosts known to NCP, 
format. 



in ASCIZ 
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HOSTN gives information for each host name known to 

NCP. 

e.g. Bit 0=> server host 
1=> user host 
3=> nickname 
6 - 8=> host type 
9 -12=> host name 
RH => index of name in HSTNAM 

The following parallel tables are indexed by an internal 
connection number. 



NETLSK,NETFSK Local and foreign socket numbers respectively 

for this connection 



NETAWD 

NETBAL 
NETSTS 



B0-8 Link, B9-17 foreign host, B18-26 
Internal uses, B27-35 index into IMPLTl thru 
IMPLT4 . 

Bit allocation 

LH Control and Status Bits, 
RH Control and Status Bits 



NETBUF 



Line number for 
otherwise undefined 



terminal connections , 



NETBTC 



Number of bits sent or received since socket 
was created. 



The following 4 tables are parallel, referenced by another 
internal index. Their contents are subject to change. For 
current descriptions of these tables, see the monitor 
program IMP DV. MAC. 



IMPLTl 
IMPLT2 
IMPLT3 
IMPLT4 

LHOSTN 



Internal uses 

Internal uses 

Internal uses 

B0-19 Internal 
allocation. 



uses, 



B20-35 



message 



Has the local host number as its first entry, 
and -n,,m as its second, where n= the number 
of network PTYs and m= the number of the 
first PTY. 
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SYSGT JSYS 16 

Gets table number, length, and entry for a named system 
table, i.e., system get table. 

ACCEPTS IN 1: SIXBIT table name 

SYSGT 

RETURNS +1: ALWAYS 

1: entry of table 

2: LH: negative of number of entries in table 
RH: table number for use with GETAB 
or in 2 if table not found 



GETAB JSYS 10 

Gets a specified word from a (numerically) specified table. 

Table numbers should always be obtained at run time with 
SYSGT; they should not be coded into programs because they 
will change. 

ACCEPTS IN 1: LH: index into table 
RH : table number 

GETAB 

RETURNS +1: unsuccessful, error code in 1 

+2: success, 36 bit number from table in 1 

GETAB ERROR MNEMONICS: 

GTABXl illegal table number 
GTABX2 illegal index 

(less than -1 or greater than length of table) 
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Section 3 Index 



DBUGSW 12 

DEVCHR 10 

DEVNAM 10 

DEVUNT 10 

DRMERR . .10 

DSKERR 10 

ENTFLG 12 

error numbers ...5 

ERSTR 6 

GETAB 14 

GETER 7 

GETNM 8 

GJINF 1 

GTAD 4 

GTDAL 8 

GTRPI 8 

HOSTN 13 

HSTNAM 12 

IMP 12 

IMPHRT 12 

IMPLTl 13 

IMPLT2 13 

IMPLT3 13 

IMPLT4 13 

JOBDIR 9 

JOBNAM 12 

JOBRT 9 

JOBTM 3 

JOBTTY 9 

LHOSTN 13 

LOGDES 12 

NCPGS 9 

NETAWD 13 

NETBAL . 13 

NETBTC 13 

NETBUF 13 

NETFSK 13 

NETLSK .13 

NETRDY 12 

NETSTS 13 

PGSTAT 10 
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QTIMES 11 

RUNTM 2 
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SETNM 7 
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SPFLTS 12 

STAD 4 

STIMES 12 

SWAKES 12 

SWTCH 3 

SYMTAB 12 

SYSGT 14 

SYSTAT 11 

System Tables 9 

SYSVER 10 

TICKPS 9 

TIME 2 

TTYJOB 9 

VERNUM 10 
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SPECIAL DEVICES 



INTRODUCTION 



This section deals with the various JSYS's for talking 
to special devices in the system. These devices include 
Magtape, DECtape, paper tape reader, paper tape punch, line 
printer, etc. Also included in this section is a discussion 
of the JSYS"s which are actually file system JSYS's but are 
implemented only for terminals. 

Many JSYS's in this section take a TENEX device 
designator as an argument. This can be: 

LH: 600000+device type number 

RH: unit number (-1 for non-unit device) 



or: 



LH: 

RH: 400000+a terminal number 

or 777777 for controlling terminal. 



The various devices are: 



name description 

DSK: disc 
DRM : drum 



MTAn: magnetic tape 

DTAn: DECtape 

PTR: paper tapo reader 

PTP: paper tape punch 

DSP: display 

LPT: line printer 

CDR: card reader 

CDP: card punch 

TTY : terminal 

TTP: terminal punch 

TTR: terminal reader 

NIL: nothing device 



NET: ARPA Network 
PLT: Calcomp Plotter 



type units? 


1 



2 

3 

4 

5 

6 

7 

10 

11 

12 

13 

14 

15 



yes 
yes 



yes 



can not be 
explicitly 
referenced 



16 
17 



NOT IMPLEMENTED 
NOT IMPLEMENTED 

NOT IMPLEMENTED 
NOT IMPLEMENTED 
an infinite sink 
for unwanted 
output; an 
infinite source of 
zeros for input 
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Notes on Some Devices 



For some devices , "device dependent status bits" are 
described. These bits are manipulated with the JSYS'S GDSTS 
and SDSTS, described in this section. 



Line Printer 

I.PT : 

The line printer accepts 12 8 character codes (0-177 
octal) each of which normally causes a character to be 
printed on the line printer as shown in figure 4-1. 
Exceptions to this are the format control characters as 
described below. All vertical format controls (except for 
form feed) are simulated by multiple line feeds for both 
compatibility with other printers and the increased 
reliability of not relying on the printer format control 
tape ! 

Line printer spooling is in effect in TENEX. Normally 
output directed to LPT: will be saved on a file and queued 
for printing. A LPT scheduler selects files for printing 
based on their length and time-of -write. Very long files 
(greater than 120,000 characters) will not be printed during 
defined prime time except as specifically directed by the 
operators. LPl: opened by an enabled WHEEL or OPERATOR will 
go direct to the line printer. 
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CODE 



NAME 



ACTION 



null 

11 tab 

12 line feed 

13 vertical tab 

14 form feed 

15 carriage return 

20 half page 

21 alternate lines 

22 three lines 

23 next line 



24 


sixth page 


37 


end of line 


177 


escape 



normally prints nothing. 

skips to the next of every 
8th column on the same line. 

skips to next line same column 
(last six lines of each page 
are skipped) 

skips to the line at the next 
third of a page same column. 

skips to the top of the 
next page, same column 

returns to column of the 
current line, no paper advance. 

skips to the next half page, 
same column. 

skips to the next even line, 
same column. 

skips to the next of every 
third line, same column. 

skips to the next line without 
skipping the last six lines 
on a page, same column. 

skip to the next sixth of 
a page, same column 

same as carriage return — 
line feed. 

causes any special action 
of the next character to 
be ignored, e.g. 

177,0 
will print code (unslashed 0) 

177, 177 
will print code 177 (hat) 
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Code Char 


Code 


Char 


Code 


Char 


Code 


Char 


unslashed 


40 


space 


100 


§ 


140 


V 


1 


alpha 


41 


• 


101 


A 


141 


a 


2 


beta 


42 


m 


102 


B 


142 


b 


3 


gamma 


43 


# 


103 


C 


143 


c 


4 


delta 


44 


$ 


104 


D 


144 


d 


5 


epsilon 


45 


% 


105 


E 


145 


e 


6 


zeta 


46 


& 


106 


F 


146 


f 


7 


theta 


47 


• 


107 


G 


147 


9 


10 


lambda 


50 


( 


110 


H 


150 


h 


11 


mu 


51 


) 


111 


I 


151 


i 


12 


xi 


52 


* 


112 


J 


152 


j 


13 


Pi 


53 


+ 


113 


K 


153 


k 


14 


rho 


54 


9 


114 


L 


154 


1 


15 


sigma 


55 




115 


M 


155 


m 


16 


tau 


56 


• 


116 


N 


156 


n 


17 


phi 


57 


/ 


117 





157 


o 


20 


psi 


60 





120 


P 


160 


P 


21 


omega 


61 


1 


121 


Q 


161 


q 


22 


delta 


62 


2 


122 


R 


162 


r 


23 


gamma 


63 


3 


123 


S 


16 3 


s 


24 


Pi 


64 


4 


124 


T 


164 


t 


25 


phi 


65 


5 


125 


U 


165 


u 


26 


sigma 


66 


6 


126 


V 


166 


V 


27 


omega 


67 


7 


127 


W 


167 


w 


30 


dagger 


70 


8 


130 


X 


170 


X 


31 


tilde 


71 


9 


131 


Y 


171 


y 


32 


del 


72 


• 
• 


132 


Z 


172 


z 


33 


arrow 


73 


• 


133 


[ 


173 


{ 


34 


infinity 


74 


< 


134 


\ 


174 


1 


35 


integral 


75 


= 


135 


] 


175 


} 


36 


+- 


76 


> 


136 


+ 


176 


'—» 


37 


underline 


77 


? 


137 


+■ 


177 


hat 



Figure 4-1 

This is compatible with the DEC PDP-10 modified ASCII code 
with the characters from - 37 as chosen by BBN for BBN'S 
Anelex printer. Note; 19 68 ASCII and many new terminals 
and printers wiTT Have different characters for codes 136 
(carat), 137 (underscore) and 176 (tilde). 
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Magnetic- ,Tape 

MTAn: 

Magnetic tape device dependent status bits: 

B18 illegal write 

B19 device error (hung or data late) 

B20 data error 

B21 suppress automatic error correction 

B22 device EOF mark 

B23 incorrect record length (not same # words as 

specified by read op or not whole # words) 

B24 beginning of tape 

B25 end of tape 

B26 paritv: 1 = even 

B27-28 density: 00=800, 01=200, 10=556, 11=800 

B29-31 character counter if B23=l 

B32-35 1 

Magtape I/O is currently available in TENEX only via the 
DUMPI/O JSYS's described in section 2. Magtape control 
functions are performed via the. MTOPR JSYS also in section 
2. 
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Paper Tape Reader and Pu nch 
PTR: PTP: 



Both reader and punch operate in 4 formats. These are named 

ASCII, IMAGE, BINARY, and IMAGE BINARY. If the reader or 

punch is operated in mode 0, the format is assumed IMAGE if 

the byte size is 8, BINARY if the byte size is 36, and ASCII 
otherwise. Any of the 4 formats may be forced by opening in 

mode 1 for ASCII, mode 10 for IMAGE, mode 13 for IMAGE 
BINARY and mode 14 for BINARY. 

The data modes affect operation as follows. 

A (ASCII, mode 1) - In ASCII format, nulls are ignored on 
output; nulls, rubouts , and tapefeed are ignored on input. 
Each formfeed (character code 14) is followed by 8 lines of 
tapefeed; each horizontal or vertical tab (character codes 
11 and 13) is followed by a rubout. Each character is 
punched with an odd parity bit in channel 8 and the 7 data 
bits in channels 7 to 1. The parity is ignored on input. 

I (Image, mode 10) - Eight-bit characters are punched 
exactly as they appear in the buffer with no additional 
processing. 

IB (Image Binary, mode 13) - Binary words are split into six 
6-bit bytes and punched with the eighth hole punched in each 
line. There is no format control or checksumming performed 
by the I/O routine. Data punched in this mode is read back 
by the paper- tape reader in the IB mode. Lines of tape 
without the 8th hole punched are ignored. The 7th hole is 
ignored. 

B (Binary, mode 14) - Each sequence of 40(8) words is 
punched as one checksummed binary block. Each block is 
preceded by a header word which contains a count of the data 
words in the block in the right half, and a 12-bit folded 
checksum in the left half. The checksum is the 12-bit l's 
complement sum of the 3 12-bit bytes of the 2's complement 
sum of the data words in the block. In BINARY format 
output, each block except the last contains 32 data words 
and is followed by 8 lines of tapefeed. Several blank lines 
are punched after each bufferful for visual clarity. 

When the PTP is opened, 128 lines of tapefeed are punched 
preceding the first line(s) of data. When the PTP is 
closed, 256 lines of tapefeed are punched following the last 
line of data. 
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CALCOMP Model 665 Plotter 



PLTs 



12" wide paper, 2 step sizes 



Open PLT: causes about 6" of paper to be slewed. The system 
routines maintain a "fence" that prevents a user from going 
off the edge of the paper. The pen is assumed to be 
centered in the Y direction when PLT: is opened, and users 
should leave the pen in a similar place when PLT: is closed. 

The plotter accepts 5-bit bytes to direct its motion as 
shown below: 

+y 



7 
31 



33 
27 
26. 



20 



35 
5 



25 
37 



32 
21 
.22 



1 
30 
.2 



+X 



PEN UP=11 
PEN D0WN=12 
OTHERS ARE NOP ■ S 



24 
4 



23 

36 



34 
3 



Moving in the +X direction slews paper on to the floor. The 
+Y direction is arranged so that the coordinate system is 
right handed. 

Standard software (line-drawing, characters, etc.) is 
available in the FORTRAN library. See other documents for 
description. 
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GENERAL 

ASND JSYS 70 
Assigns a device to caller 
ACCEPTS IN 1: a TENEX device designator 

ASND 
RETURNS +1: unsuccessful, error # in 1 

+2: successful (or already assigned to caller). 

ASND ERROR MNEMONICS: 

DEVXl: illegal TENEX device designator 

DEVX2: device already assigned to another job 

ASNDXl: device not assignable (eg DSK:) 

ASNDX2: illegal to assign this device 

ASNDX3: no such device 



RELD JSYS 71 

Releases an assigned device 

ACCEPTS IN 1: a TENEX device designator 

or -1 to release all devices assigned to this 
job 

RELD 

RETURNS +1: unsuccessful, error # in 1 

+2: successful 

RELD ERROR MNEMONICS: 

DEVXl: illegal TENEX device designator 

DEVX2: specified device assigned to another job 
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CSYNO JSYS 72 

Creates a new name synonym by which the known device can be 
referenced. The synonym is private to this job and synonyms 
are searched first. Old name and new name may be used 
interchangeably. 

NOT IMPLEMENTED YET 

ACCEPTS IN 1: a string pointer to the known device name or a 
device designator 

2; a string pointer to the new device name 

CSYNO 

RETURNS +1: unsuccessful, error # in 1 

+2: successful, updated string pointers in 1,2 

Note that devices can only be renamed to devices. E.g., one 
cannot rename a device to a disc file J 

CSYNO ERROR MNEMONICS: 

DESXl: illegal TENEX source/destination designator 
ASNDX3: no such device 
CSYNXl: synonym already in use 
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GDSTS JSYS 145 
Get device status 
ACCEPTS IN 1: JFN 

GDSTS 

RETURNS +1: always, with device dependent status bits in 

2; 

AC3: Device dependent. For MTA: , 

word count of last transfer completed, 

negative if last attempted transfer 

unsuccessful • 

Currently a NOP for devices without device dependent status 
bits 

Gives illegal instruction PSI on the following errors; 

DESXl: illegal value for designator 

DESX2: terminal not available to this job 

DESX3: no name for this JFN 

DESX4: terminal designator or string pointer not 

legal 
DESX5: not open 
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SDSTS JSYS 146 

Set device Status 

ACCEPTS IN 1: JFN 

2: new status bits 

3: Device dependent: for 
ADC: and ADC: only r 
control bits 

SDSTS 

RETURNS +1: always 

Currently a NOP for devices without device dependent 
statuses. 

Gives illegal instructon PSI on the following errors: 

DESXl: illegal value for designator 

DESX2: terminal not available to this job 

DESX3: no name for this JFN 

DESX4: terminal designator or string pointer not 

legal 
DESX5: not open 
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TERMINAL SPECIFIC 



INTRODUCTION 



The JSYS's in this sub-section are currently 
implemented for use with terminals only; they have no effect 
or return default-value information when used with other 
devices. 

Most JSYS's in this section are specified as giving an 
error if the device referenced is assigned to another job. 
However, it is legal to reference a terminal assigned to 
another job (as controlling terminal or with ASND) if the 
process executing the JSYS has the WHEEL special capability 
enabled. 
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JFN Mode Word 

Each terminal in TENEX has an associated mode word of the 
following form. It is expected that such a word will also 
be associated with each JFN . This word can be read with 
RFMOD and changed with SFMOD and STPAR (all in this 
section) . 

A JFN which identifies a terminal (obtained from TTYn:) and 
which is opened in binary mode does not affect the terminal 
data mode of that terminal line, but instead performs binary 
input/output without reference to the terminal mode word. 
To open a terminal JFN in binary, the by-fop size should be 8, 
and the data mode should be (default) or binary. A byte 
size of 8 with other data modes, or binary data mode with a 
byte size other than 8 are illegal. 

bit function 

FT"" output active (cannot be changed by SFMOD) 
1: has mechanical form feed 
2 : has mechanical tab 
3: has lower case 
4-10: page length 
11-17: page width 
18-23: wakeup control 
on: 
18: - 
19: - 

20: formatting controls (10,11,12,14,15,33,37) 
21: non- formatting controls 

22: punctuation char 40-177 except those covered by 
bit 23 

23: alphanumeric char 0-9 capital A - Z, lower case a - z 
24-25: echo mode 

00: no echo 

01: immediate echo only 
10: immediate or deferred 
11: immediate and deferred 
26: accept links if 1 
27: allow advice if 1 
28-29: terminal data mode 

00: "binary" 8-bit in and out; 
no format control or control 
group translation. No echoing. 
01: "ASCII" - 7-bit in and out, 
plus parity on control group 
output. Format control and 
simulation, translation of 
control group on in (echo) 
and out as per SFCOC words. 
10: Same as 01 except translation 
of control group for echoing 
disabled. 
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11: Same as 01 except translation 
of control group for output 
disabled. 
30: (lco) lower case output control 

: do not indicate 

1: indicate by %X 
31: (lei) lower case input control 

0: no conversion 

1: convert lower to upper 
32-33: Full/Half duplex control 

00 - Full duplex 

10 - Character half duplex 

11 - Line half duplex 

01 - Reserved 

34: repeat last character (set by BKJFN, not affected by 

SFMOD) 
35: If line is a dataset r on if "carrier is on" 

If line is not a dataset, unspecified 
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Control Character Output Control 

Each terminal has two control character output control 
(CCOC) words, consisting of 2-bit bytes, one for each of the 
characters 0-37, interpreted as follows: 



00 
01 
10 
11 



IGNORE (send nothing) 

indicate by + X 

send actual code and account format action 

simulate format action and account 



The specific bytes for each character are given in the 
character set table (below) ; these words can be manipulated 
with RFCOC and SFCOC, described in this section. 

TERMINAL CHARACTERISTICS CONTROL 

TENEX provides capabilities for adjusting the behavior of 
the terminal output processing to suit various types of 
terminals. The characteristics which can be matched are: 

1. mechanical form- feed, and tab present/ absent 
on a device, 

2. lower case available on a device 

3. padding after carriage-return needed 

4. padding after line-feed needed 

5. padding after mechanical tab needed 

6. padding after mechanical form-feed needed 

Additional characteristics will be provided for as devices 
appear needing them. 

Rather than provide for the independent setting of each of 
these parameters for each line (which would be costly in 
terms of resident storage) , a number of known terminals have 
been identified, and each of the above parameters for each 
terminal has been specified. The terminal type may be 
specified for each line, and that specification implies the 
appropriate set of the above parameters. JSYS's have been 
implemented to allow reading and setting the terminal type. 
The following terminal type number specifications have been 
made: 
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Number 



Terminal 



Characteristics 



TTY mod 33 
TTY mod 35 
TTY mod 37 



no mechanical format, no padding 
mechanical FF and TAB, pad TAB, pad CR 
no mechanical format, has lower case 



TI/EXECUPORT has lower case, pad CR 
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control, see 



Character Set 

The following table gives information pertinent to the 
JSYS's in this section about each character in the TENEX 
character set. The "class" (used for wakeup 
JFN Mode Word), is abbreviated as follows: 

F formating control character 

C non- formatting control character 

P punctuation character 

A alphanumeric character 









character 






term. 


ASCII 




output 
control 






code 


code 








dec. 


oct. 


class 


word-bits 


character/ + equivalent 








C 


1-B0,1 


t@ 


null, break 


1 


1 


C 


1-B2,3 


tA 




2 


2 


C 


1-B4,5 


+B 




3 


3 


C 


1-B6 r 7 


+C 




4 


4 


C 


1-B8,9 


+ D 




5 


5 


C 


1-B10,11 


fE 




6 


6 


C 


1-Bl2,13 


tF 




7 


7 


C 


1-B14,15 


tG 


bell 


8 


10 


F 


1-B16,17 


tH 


backspace 


9 


11 


F 


1-B18,19 


tl 


tab 


10 


12 


F 


1-B20,21 


tJ 


line feed 


11 


13 


C 


1-B22,23 


tK 


vertical tab 


12 


14 


F 


1-B24,25 


tL 


form feed 


13 


15 


F 


1-B26,27 


+M 


carriage return 


14 


16 


C 


1-B28,29 


+N 




15 


17 


C 


1-B30,31 


+0 




16 


20 


C 


1-B32,33 


+P 




17 


21 


C 


1-B34,35 


tQ 




18 


22 


C 


2-B0,l 


+ R 




19 


23 


C 


2-B2 f 3 


+ S 




20 


24 


C 


2-B4,5 


+ T 




21 


25 


C 


2-B6,7 


+ U 




22 


26 


C 


2-B8,9 


tv 




23 


27 


c 


2-Bl0,ll 


tw 




24 


30 


c 


2-Bl2,13 


+ X 




25 


31 


c 


2-Bl4,15 


+Y 




26 


32 


c 


2-Bl6,17 


tz 




27 


33 


F and C 


2-Bl8,19 


+ 1 


esc, alt mode 




34 


C 


2-B20,2l 


+ 






35 


C 


2-B22,23 


+ ] 






36 


C 


2-B24,25 


ft 






37 


F 


2-B26,27 


t-e 


EOL end-of-line 
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40 


P 


41 


P 


42 


P 


43 


P 


44 


P 


45 


P 


46 


P 


47 


P 


50 


P 


51 


P 


52 


P 


53 


P 


54 


P 


55 


P 


56 


P 


57 


P 


60-71 


A 


72 


P 


73 


P 


74 


P 


75 


P 


76 


P 


77 


P 


100 


P 


101-132 


A 


133 


P 


134 


P 


135 


P 


136 


P 


137 


P 


140 


P 


141-172 


A 


173 


P 


174 


P 


175* 


P 


176* 


P 


177 


P 



space 
i 



/ 

0-9 



> 
? 

@ 

upper case letters A-Z 
[ 

] 

+ (carat on some terminals) 

■*- (underline on some terminals) 

accent grave 

lower case letters a-z 

left curly brace 

vertical bar 

right curly brace 

tilde 

rubout 



* If terminal does not have lower case (JFN mode word B3 
off) , 175 and 176 are converted to 33 on input, and 
treated accordingly. 
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CFIBF JSYS 100 

Clears designated file input buffer 

ACCEPTS IN 1: TENEX file designator 

CFIBF 

RETURNS +1: always 

Acts like a NOP if designator associated with non- terminal. 
Generates illegal instruction PSI on error conditions below. 

CFIBF ERROR MNEMONICS: 

DESXl: illegal TENEX source/destination designator 

DESX3: no name for this JFN 

DESX5: not open 

DESX6: string pointer not legal 

DEVX2: specified device assigned to another job 



CFOBF JSYS 101 

Clears designated file output buffer 

ACCEPTS IN 1: TENEX file designator 

CFOBF 

RETURNS +1: always 

Acts like a NOP if designator associated with non- terminal. 
Generates illegal instruction PSI on error conditons below. 

CFOBF ERROR MNEMONICS: 

DESXl: illegal TENEX source/destination designator 

DESX3: no name for this JFN 

DESX5: not open 

DESX6: string pointer not legal 

DEVX2: specified device assigned to another job 
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SIBE JSYS 102 

Skips if designated file input buffer empty 

ACCEPTS IN 1: TENEX file designator 

SIBE 

RETURNS +1: with number of bytes now in input buffer in 2 

+2: input buffer empty, 

transparent to all AC's 

Generates illegal instruction PSI on error conditions below. 
Does not skip if designator associated with non- terminal. 

SIBE ERROR MNEMONICS: 

DESXl: illegal value for designator 

DESX3: no name for this JFN 

DESX5: not open 

DESX6: string pointer not legal 

DEVX2: specified device assigned to another job 



SOBE JSYS 103 

Skips if designated file output buffer empty 

ACCEPTS IN 1: TENEX file designator 

SOBE 

RETURNS +1: with number of bytes now in 
output buffer in 2 

+2: output buffer empty, 

transparent to all Ac's 

Generates illegal instruction PSI on error conditions below 
Always skips if designator associated with non-terminal. 

SOBE ERROR MNEMONICS: 

DESXl: illegal value for designator 

DESX3: no name for this JFN 

DESX5: not open 

DESX6: string pointer not legal 

DEVX2: specified device assigned to another job 
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SOBF JSYS 175 

Skips if designated file output buffer is full 

ACCEPTS IN 1: TENEX file designator 

SOBF 

RETURNS +1: output buffer not full 

+2: output buffer full 

On either return, the number of bytes in the output 
buffer is returned in 2. 

SOBF ERROR MNEMONICS: 

DESXl: illegal value for designator 

DESX3: no name for this JFN 

DESX5: not open 

DESX6: string pointer not legal 

DEVX2: specified device assigned to another job 
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DIBE JSYS 212 

Dismiss until designated file input buffer is empty. 

ACCEPTS IN 1: TENEX file designator 

DIBE 

RETURNS +1: always 

If designator is associated with non-terminal , returns when 

end of file condition appears or file is closed. 

Generates illegal instruction PSI on error conditions below. 

DIBE ERROR MNEMONICS: 

DESXl: illegal value for designator 

DESX3; no name for this JFN 

DESX5: not open 

DESX6: string pointer not legal 

DEVX2: specified device assigned to another job 



DOBE JSYS 104 
Dismiss until designated file output buffer is empty 
ACCEPTS IN 1: TENEX file designator 

DOBE 
RETURNS +1: always 

Generates illegal instruction PSI on error conditions below. 
Returns immediately if designator associated with 
non-terminal • 

DOBE ERROR MNEMONICS: 

DESXl: illegal value for designator 

DESX3: no name for this JFN 

DESX5: not open 

DESX6: string pointer not legal 

DEVX2: specified device assigned to another job 
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GTABS JSYS 105 

Get tab settings for a particular file 

ACCEPTS IN 1: TENEX file designator 

GTABS 

RETURNS +1: always with tab settings in accumulators 2,3,4 

These accumulators are interpreted as a 107-bit bit string, 
with B0 of AC2 ignored, and each remaining bit indicating 
the presence of a tab in the corresponding column. 

Bl of AC2 for column 1 
B0 of AC3 for column 36 
B0 of AC4 for column 72 

Returns tab every 8 places if designator associated with 
non- terminal • 

Generates illegal instruction PSI on error conditions below 

GTABS ERROR MNEMONICS: 

DESXl: illegal value for designator 

DESX3: no name for this JFN 

DESX5: not open 

DESX6: string pointer not legal 

DEVX2: specified device assigned to another job 
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STABS JSYS 106 

Sets tabs for a particular file 

ACCEPTS IN 1: TENEX file designator 

2,3,4: 3 words worth of tab setting bits, same format 
as GTABS 

STABS 

RETURNS +1: always 

Acts like a NOP if designator associated with non- terminal. 
Generates illegal instruction PSI on error conditions below. 

STABS ERROR MNEMONICS: 

DESXl: illegal value for designator 

DESX3: no name for this JFN 

DESX5: not open 

DESX6: string pointer not legal 

DEVX2: specified device assigned to another job 
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RFMOD JSYS 107 

Reads a file's mode 

ACCEPTS IN 1: TENEX file designator 

RFMOD 

RETURNS +1: always , mode word in 2 

Returns +D66Bl0+tD72Bl7+7B3+actual data mode bits in 2 if 
designator associated with non- terminal. (See this section 
- JFN Mode Word.) 

Generates illegal instruction PSI on error conditions below. 
RFMOD ERROR MNEMONICS: 

DESXl: illegal value for designator 

DESX3: no name for this JFN 

DESX5: not open 

DESX6: string pointer not legal 

DEVX2: specified device assigned to another job 
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SFMOD JSYS 110 
Sets a particular file's modes 
ACCEPTS IN 1: TENEX file designator 
2 : mode word 

SFMOD 
RETURNS +1: always 

The fields of the JFN mode word affected by SFMOD are: 



B 18-2 3, wakeup control 

B24-25, echo mode 

B28-29, terminal data mode 

B31 convert case on input 



Acts like a NOP if designator associated with non- terminal. 
Generates illegal instruction PS I on error conditions below, 

SFMOD ERROR MNEMONICS: 

DESXl: illegal value for designator 

DESX3: no name for this JFN 

DESX5: not open 

DESX6: string pointer not legal 

DEVX2: specified device assigned to another job 
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STPAR JSYS 217 

Sets the terminal parameters for a particular terminal line. 

ACCEPTS IN 1: TENEX file designator which must designate 

a terminal. 

2 : mode word 



STPAR 



RETURNS +1 always. 



The fields of the JFN mode word affected by STPAR are: 

Bl,2,3 - mechanical characteristics: form feed, tab, 

lower case 
B4-10 - page length 
Bll-17 - page width 
B30 - convert case on output 
B32-33 - duplex mode 



Generates illegal instruction PSI if given non-terminal 
designator. 
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The following JSYS f s deal with the terminal type number. 



STTYP JSYS 302 



Sets the terminal type number for a terminal line, 

ACCEPTS IN 1: TENEX file designator which must identify 

a terminal line. 

2 : a terminal type number 



STTYP 



RETURNS +1: always 

The terminal type number is set for the specified line. The 
three bits specifying mechanical tab, mechanical form- feed, 
and lower case are loaded into the JFN mode word from the 
device characteristics table, and they may be subsequently 
changed by STPAR if desired. An illegal instruction PSI is 
generated on error conditions below. 



STTYP ERROR MNEMONICS: 

DESXl: designator does not identify terminal line 
STYPXl: terminal type number out of legal range 
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GTTYP JSYS 30 3 



Gets the terminal type number for a terminal line. 

ACCEPTS IN 1: TEMEX file designator which must identify a 

terminal line. 

GTTYP 

RETURNS +1: always, with terminal type number in 2, and 

buffer allocation numbers in 3 (LH: number of 
buffers allocated on input, RH: number of 
buffers allocated on output) . Generates an 
illegal instruction PS I on error conditions 
be low . 

GTTYP ERROR MNEMONICS: 

DESXl: designator does not identify terminal line. 



RFPOS JSYS 111 

Reads a particular file's position 

ACCEPTS IN 1: TENEX file designator 

RFPOS 

RETURNS +1: always, position in 2 

bits 0-17: position within a page (i.e., line 
number) . Line number set to zero only when +L 
(FF) typed, and upon LOGIN. 

bits 18-35: position within a line (i.e., 
column number) 

Generates illegal instruction PSI on error conditions below. 
Returns in 2 if designator associated with non-terminal. 

RFPOS ERROR MNEMONICS: 

DESXl: illegal value for designator 

DESX3: no name for this JFN 

DESX5: not open 

DESX6: string pointer not legal 

DEVX2: specified device assigned to another job 
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RFCOC JSYS 112 

Reads a file's control character output control 

ACCEPTS IN 1: TENEX file designator 

RFCOC 

RETURNS +1: always, output control words in 2 and 3 

Returns 525252525252 in 2 and 3 if designator associated 
with non- terminal. 

Generates illegal instruction PSI on error conditions below. 

RFCOC ERROR MNEMONICS: 

DESXl: illegal value for designator 

DESX3: no name for this JFN 

DESX5: not open 

DESX6: string pointer not legal 

DEVX2: specified device assigned to another job 



SFCOC JSYS 113 

Sets a file's control character output control 

ACCEPTS IN 1: TENEX file designation 

2,3: output control words 

SFCOC 

RETURNS +1: always 

Generates illegal instruction PSI on error conditions below. 
Acts like NOP if designator associated with non-terminal. 

SFCOC ERROR MNEMONICS: 

DESXl: illegal value for designator 

DESX3: no name for this JFN 

DESX5: not open 

DESX6: string pointer not legal 

DEVX2: specified device assigned to another job 
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STI JSYS 114 

Simulate terminal input 

ACCEPTS IN 1: TENEX file designator (only terminal 
designators are legal) 

2: the character (right justified) to be input 

STI 

RETURNS +1: always 

The character is put into the input buffer whether or not 
the input buffer is empty. DIBE can be used to prevent 
sending an interrupt character (e.g., +C) before the program 
has processed all of the previous input. 

Generates illegal instruction PSI on error conditions below 

STI ERROR MNEMONICS: 

TTYXl: a non-terminal designator or non-existing 

terminal was specified 
DEVX2: specified device assigned to another job 



DTACH JSYS 115 
Detaches the controlling terminal from a job 

DTACH 

RETURNS +1: always 

Acts like a NOP if job is already detached. Appends console 
detached entry to FACT accounting file on actual detach. 
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ATACH JSYS 116 

Attaches the controlling terminal to a job 

ACCEPTS IN 1: the tss job number of the designated job 

2: left half: 

B0 off, when the job gets attached it simply 

continues running 

B0 on, when the job gets attached, a +C is 

faked 

NOT IMPLEMENTED YET 

right half: 

the directory number under which the job to be 

attached is logged in. 

3: a string pointer to the beginning of an ASCIZ 
password string in the address sp>ace of caller 



RETURNS 



ATACH 



+1: unsuccessful, error # in 1 



+2: successful, If job executing ATACH was logged 
in, this job is now detached with primary I/O 
not redirected; hence, if a process had 
primary I/O from the controlling terminal, it 
will hang when it attempts primary I/O. 
If job executing ATACH was not logged in and 
ATACH is successful, the job quietly goes 
away. ATACH appends a console attached entry 
to the FACT accounting file. 

It is normally illegal to ATACH to a job which already has a 
controlling terminal. However, if the process executing 
ATACH has the WHEEL or OPERATOR special capability enabled, 
it can ATACH to a job regardless of whether it has a 
controlling terminal and whether or not the directory and 
password given are correct. 



ATACH ERROR MNEMONICS: 

ATACXl: illegal job number 

ATACX2: job already attached to a controlling terminal 

ATACX3: directory number does not match 

ATACX4: password incorrect 

ATACX5: job executing ATACH has no controlling terminal 
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Terminal Linking 

It is possible to link the output of any line to up to four 
other lines. A linked line gets exactly what the source 
line gets; the linked line has no effect on the formatting 
of the source line. (In particular, a linked line can 
overstrike at the right margin because the combined string 
from the link and from the controlling job can total more 
than 72 printing characters, without a carriage return. 
Note also that if the source line has mechanical tab, the 
linked line will also be sent the tab whether or not it also 
has mechanical tab.) 

Internally, linking is accomplished by placing the desired 
'remote' line number in any of the four 9-bit fields of word 
TTLINK (SOURCE) . The accept/refuse message bit is defined to 
be bit 26 in the terminal (JFN) mode word. It can be read 
by RFMOD, but cannot be set by SFMOD (for backward 
compatibility reasons) . Rather, it is set by one of the 
options of TLINK described below. 
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TLINK JSYS 216 

Terminal link control 

ACCEPTS IN 1: XWD function bits, object designator 
2: remote designator 

TLINK 

RETURNS +1: failure, error code in 1 
+2: success 

The object and remote designators are standard file 
designators. However, only 4xxxxx and 77777 are allowed. 
The function bits are executed from left to right (0 to 17) 
and organized in what should be the most useful order. 

B0 clear link from remote (all if -1) to object 
Bl clear link to remote (all if -1) from object 

B2 establish link to remote from object 
B3 establish link from remote to object 

B4 set accept bit for object to state specified by bit 5 
B5 desired state of accept bit if bit 4 on 

Restrictions if not WHEEL: 

Object designator must specify TTY assigned to this job. 

•object- to-remote 1 must be done before • remote-to-object • 
(but can be done in same instruction) 

If accept bit of remote is off, 'object- to- remote 1 will 
cause ringing of remote bell; if remote does not set accept 
in 15 seconds, TLINK will return failure. 

TLINK ERROR MNEMONICS: 

DESXl: illegal designator 
TLNKX1: attempt to set remote to object 
before object to remote 
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ADVIZ JSYS 315 
Sets up terminal lines useful for the ADVIZing function, 

ACCEPTS IN 1: LH: 

B0 clear ADVIZ link 

Bl set to ADVIZ line given in right half 
B2 set to receive advice front designated line 
in RII 

RH: terminal line designator 

RETURNS +1: error, error code in ACl 
+2: Success 

ADVIZ 

An ADVIZ link is established by having the advisee execute a 
"receive advice" (B2) designating the intended advisor, and 
then the advisor executing a "send advice" (Bl) designating 
the advisee line. An ADVIZ link causes the advisor's 
characters to be input to the advisee's job. ADVIZ provides 
terminal output using the TLINK mechanism. While ADVIZ is 
in progress, a tC character typed by the advisor causes the 
ADVIZ link to be broken, but leaves the output link in 
effect, A tC will be sent to the advisee job when the 
advisor types a +Y. 

ADVIZ ERROR MNEMONICS: 



ADVXl: advice refused 
ADVX2: not used 

ADVX3: Bl and B2 of ACl both on in call 

ADVX4: an attempt to accept advice with ADVIZ already in 
progress 

TLINK errors can also occur. 
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ASNDP JSYS 260 

Assign Display Process 

ASNDP 

RETURNS +1: error, no display processes available 

+2: success with the assigned display 
process number in ACl 



RELDP JSYS 261 

Rele ase Display Process 

ACCEPTS IN 1: a display process number or -1 to release 
all display processes assigned to this job 

RELDP 

RETURNS +1: always, the indicated display processes are 
deassigned if they had been assigned. If the 
processes were running, they are first stopped 
with STPDP. 



ASNDC JSYS 262 

Assign Display Console 

ACCEPTS IN 1: a mask of ones for each display console to be 

assigned, B0 => console etc. 



ASNDC 



RETURNS +1: error, cannot assign one or more of the 

requested consoles, no consoles are assigned. 

+2: success 
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RELDC JSYS 263 

Release Display Console 

ACCEPTS IN 1: a mask of ones for each display console to be 
de as signed 



RELDC 

RETURNS . +1: always. An attempt to release an unassigned 
console is treated as a NOP. 



STRDP JSYS 264 

Start Display Process 

ACCEPTS IN 1: B0 if one, set the memory map 

Bl if one, set the frame iteration count 

B2 if one, set the console mask 

B4 if one, set the interrupt channel 
assignment words 

B5 if one, set the contents of the display 
processor registers 

RH: a display process number. 

2: location of a table to set the initial status 
of the display process. 
Only used if LH(1) is non-zero. 

STRDP 

RETURNS +1: error 

+2: success. If the process was running, it is 
stopped first. 



SPECIAL DEVICES, Section 4 l-September-73 Page 38 
DISPLAY 



Status Table Format 



map word negative count of pages, , first page 

(maximum of 100(8) pages) 

frame iteration count if 0, indefinite iteration 

if >0, an iteration count 



console mask 

CONI word 

interrupt channel' assignments 



interrupt conditions 



three words of 6 bit bytes, one byte 
for each type of display interrupt; 
byte contains channel number for 
pseudo-interrupt or 77 if not 
assigned 



byte condition 

program stop with C(Pl) > 100 

program stop with C(Pl) = 
is a frame stop 

1 stop on hit 

2 frame, iteration count completed 

3 I/O error 

4 memory-to-memory stop (WCR positive) 

5 program stop with C(P1) =1 

(display process continued 
automatically) 
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display registers 



the order of the registers is: 

WCR 

RCR 

UR 

RAR 

WAR 

DSP 

PI 

DIR 

PC 

RSR 

SR 

SP 

SAVELB 

SAVERT 

VIEWLB 

VIEWRT 

WINDLB 

WINDRT 

INSTLB 

INSTRT 

NAME 

CDIR 

HI TANG 

SELINT 



STRDP ERROR MNEMONICS: 



DPXl: 

DPX2: 
STRDXl: 
STRDX2 : 
STRDX3: 



display process number not assigned to this 

job 

illegal display process number 

invalid map word 

can not lock as many pages as specified 

page without read, write (or write copy) and 

execute access 
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STPDP JSYS 26 5 

Stop Display Process 

ACCEPTS IN 1: a display process number 

STPDP 

RETURNS +1: always. This is a NOP for non-running display 
processes or for processes assigned to other 
jobs. 
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STSDP JSYS 266 
Set Status of Display Process 
ACCEPTS IN 1: B0 if one, set the memory map 

Bl if one, set the frame iteration count 

B2 if one, set the console mask 

B4 if one, set the interrupt channel 
assignment words 

B5 if one, set the contents of the display 
processor registers 

RH: a display process number 

2: the location of the table from which to set 
the status of the indicated display process. 

STSDP 

RETURNS +1: error 

+2: Success. If the process is running, it is 
first stopped and then restarted after its 
status is changed. 

STSDP is the same as STRDP if the display process is 
running. 

STS IP ERROR MNEMONICS: 

DPXl: display process number not assigned to this 

job 
DPX2: illegal display process number 
STRDXl: invalid map word 

STRDX2: can not lock as many pages as specified 
STRDX3 : page without read, write (or write copy) and 

execute access 
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RDSDP JSYS 267 

Read Status of a Display Process 

ACCEPTS IN 2 : a display process number 

2: location where to store the status information 

RDSDP 

RETURNS +1 : error 

+2 : Success. The status information is stored in 
the same format as specified for STRDP and 
STSDP. 

IDSDP ERROR MNEMONICS: 

DPXl: display process number not assigned to this 

job 
DPX2: illegal display process number 



WATDP JSYS 270 

Wait for Display Process to Stop 

ACCEPTS IN 1: a display process number 

WATDP 

RETURNS +1: always, after waiting for the display process 
to stop 
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OTHER DEVICES 



DVCHR 



JSYS 117 



Get device characteristics. 

ACCEPTS IN 1: JFN 

or device designator 



DVCHR 



1 (even if JFN was 



RETURNS +1 : device designator in 
supplied to call) 
device characteristics in 2 
device unit number in right half of 3 
TSS job # to which device is assigned 
is) in left half of 3 



(if it 



characteristics 

B0 device can do output 

Bl device can do input 

B2 device has a directory 

B3 device is assignable with ASHD 

B4 device has multiple directories 

B5 device available or assigned to this job 

B6 device is assigned by ASND 

B7 device is mountable 

B8 device is mounted 

B9-B17 device type 

B20-B35 if on, mode is legal for mode 35-n 

Generates illegal instruction PSI on error 
conditions below. 



DVCHR ERROR MNEMONICS: 



DEVXl: 
DESXl: 
DESX3: 
DESX4: 



illegal device designator 

illegal value for designator 

no name for this JFN 

terminal designator or string 

legal 



pointer not 
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STDEV JSYS 120 

String to device designator. 

ACCEPTS IN 1: a string pointer to string of form 
DTAl (terminator) 

STDEV 

RETURNS +1: unsuccessful, error # in 2 

+2: successful, device designator in 2 

STDEV ERROR MNEMONICS: 

STDVXl: unrecognized device 



DEVST JSYS 121 

Device designator to string. 

ACCEPTS IN 1: a TENEX destination designator 

2: a device designator 

DEVST 

RETURNS +1: unsuccessful, error # in 2 

+2 j successful, with updated string pointer in 1 
(if pertinent) 

DEVST ERROR MNEMONICS: 

DEVXl: illegal device designator 

DESXl: illegal value for designator 

DESX2: terminal not available to this job 

DESX3: no name for this JFN 

DESX5: not open 
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MOUNT JSYS 122 

Mounts a device, Moun table devices such as IECtapes must be 
MOUNTed before being accessed, 

ACCEPTS IN 1: device designator 

(if B3 on do not read directory, off read 
directory) 

MOUNT 

RETURNS +1: unsuccessful, error # in 1 

+2: successful 

If device is already mounted, it is first dismounted. 
If B3 of 1 is on, a DECtape or magtape is assumed to be 
non-directory , 

MOUNT ERROR MNEMONICS: 

DEVXl: illegal device 

DEVX2: device not available 

MNTXl: illegal directory format and directory read 

specified 

MNTX2: failed to mount (e.g. device off-line) 

MNTX3: device type not moun table 

DSMXl: failed to dismount (see DSMNT) 

I/O errors can also occur 
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DSMNT JSYS 12 3 
Dismount a device. 
ACCEPTS IN 1: device designator 

DSMNT 
RETURNS +1: unsuccessful, error # in 1 

+2: successful, directory is updated if necessary 

DSMNT ERROR MNEMONICS: 

DEVXl: illegal device 

DEVX3: device wasn't mounted 

DSMXl: cannot dismount (e.g. files open on device) 



I/O errors can also occur 



INIDR JSYS 124 
Initializes the directory of a mounted device. 
ACCEPTS IN 1: device designator 

INIDR 
RETURNS +1: unsuccessful, error # in 1 

+2: successful, directory initialized 

INIDR ERROR MNEMONICS: 

DEVXl: illegal device 
DEVX3: device wasn't mounted 
INIDXl: device busy 

I/O errors can also occur 
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RDDIR JSYS 32 

Read Device DI Rectory 

ACCEPTS IN 1: device designator 

(only DECtapes currently allowed) 

2: core address 

RETURNS +1: unsuccessful, error code in 1 

+2: directory has been copied to specified address 
in caller's address space 

RDDIR ERROR MNEMONICS: 

RDDIXl: cannot read directory for this device 
(not DECtape, not mounted, etc.) 



GDSKC JSYS 214 
Get DiSK Count. JSYS to determine file storage usage. 

ACCEPTS IN 1: device designator 

(currently only 777777 for DSK: allowed) 

GDSKC 

RETURNS +1: 1: number of pages in use 
2: number of unused pages 
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FDFRE JSYS 213 

Determines File Directory FREe space. 

ACCEPTS IN 1: TENEX device designator 

(only DSK legal at present) 

2: directory number 

FDFRE 

RETURNS +1: with number in 2 representing amount of free 
space left 

For disk directories, the amount of free space left is 
returned as a number of words. 

Generates illegal instruction PSI on error conditions below. 

FDFRE ERROR MNEMONICS: 

DESXl: illegal value for designator 
DESX2: terminal not available to this job 
FDFRXl: not a multiple directory device 

(at present, not DSK) 
FDFRX2: no such directory number 



LITES JSYS 215 

Displays data in the MI lights on the central processor 
console. 

ACCEPTS IN 1: 36-bit word to be displayed 

LITES 

RETURNS +1: successful, generates illegal instruction PSI 
on error conditions listed below. 

LITES ERROR MNEMONICS: 

WHELXl: WHEEL, OPERATOR or MAINTENANCE 
special capability not 
enabled 



SPECIAL DEVICES, Section 4 l-September-73 Page 49 
OTHER DEVICES 



Section 4 index 
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PSEUDO- INTERRUPT JSYS • S 



INTRODUCTION 



This section of the manual describes the JSYS's for 
controlling the pseudo- interrupt system. The 
pseudo-interrupt system provides a means by which certain 
conditions cause control to be transferred to specified 
locations in the process called the pseudo-interrupt 
routines. Simultaneously, the process PC will be saved so 
that the pseudo-interrupt routine may resume the interrupted 
sequence upon completion of its tasks. These conditions 
are: 

(1) Terminal Pseudo Interrupts — generated when selected 

terminal keys are typed. 

(2) Illegal Instruction Traps (such as attempts to 

execute I/O instructions in ordinary user mode) or 
attempts to execute privileged monitor calls. 

(3) Memory Traps including read, write and execute, 

directed traps, and un-assigned memory. 

(4) Arithmetic Processor Traps 

(5) Unusual File Conditions (EOF, errors) 

(6) Specific Time of Day reached 

(7) Generated Pseudo- Interrupts 

(8) Subsidiary Fork Termination 

(9) System Resource Allocation traps 

There are 36 pseudo-interrupt channels and some number 
NPLEVS (currently 3) , pseudo-interrupt priority levels. 
Priority levels are numbered from 1 to NPLEV\ Is not a 
legal priority level. Most of the possible causes of PSI's 
are each permanently assigned to one of the 36 channels. 
The remainder are user-assignable to one of several of the 
36 channels. Each channel can be activated or deactivated. 
If . activated, the channel can cause an interrupt on the 
user-specified priority level. This two step interrupting 
procedure eliminates the need for user decoding of interrupt 
cause. 

An interrupt for any channel will be initiated only if there 
are no interrupts in progress on the same or higher priority 
channels. Otherwise, it will be remembered and initiated 
when the last equal or higher priority channel de-breaks. 
Since a higher level (lower priority number) interrupt can 
interrupt a lower level PSI routine, there can be up to 
NPLEVS interrupts in progress simultaneously. The user's 
PSI routine exits with a monitor call which resets the 
interrupt-in-progress status of that PSI priority level. 
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The user can turn the pseudo- interrupt system on or off. 
When the system is off, interrupt requests are remembered 
until the system is turned back on except for certain 
"panic" channels (e.g., instruction trap, described below) 
where an interrupt request will take as though the PS I 
system was always on. The user can also clear the entire 
interrupt system, thereby forgetting all stacked requests. 

Channels vs. Priority Levels 

Note carefully the distinction between channels and priority 
levels. A channel corresponds to one particular cause of 
interrupts. There is a one-to-one correspondence of 
channels and interrupt causes as shown in Table 1. Some 
interrupt causes are assignable to different channels, but 
at any given time, an interrupt cause is associated with at 
most one channel, and each channel is associated with at 
most one interrupt cause. The priority levels are provided 
to allow some interrupt conditions to be able to interrupt 
the service routine for other interrupt conditions. 

For example, a program could assign a "break key" type of 
user request (e.g., LISP's control-H) to a low priority 
level, some APR overflow conditions to a medium priority 
level, and an "abort key" user request (e.g., LISP's 
control-E) to a higher priority channel. Thus, an 
unexpected or infrequently occurring APR condition (e.g., 
PDL overflow) could be handled during the program's main 
sequence or during a user initiated break sequence, but a 
user initiated abort request would override any of the above 
sequences . 

As stated earlier, each activated PSI channel is user 
assigned to one of NPLEVS priority levels"! The user makes 
his assignment by considering when one interrupt condition 
can arrive during the servicing of another, and when 
servicing of the later interrupt cannot be deferred until 
completion of the first. Note that the pseudo-interrupt 
levels are numerically referenced as 1, 2, and 3. Level 
is not legal and in particular if a pseudo-interrupt request 
occurs in a fork where the level associated with that 
channel is 0, the system considers the fork not prepared to 
handle the interrupt, and freezes or terminates it according 
to bit 17 of the capabilities word. 
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Interrupt Service Conventions 

Before using the pseudo-interrupt system, the user must 
execute a monitor call to specify the location of his 
channel table (CHNTAB) and level table (LEVTAB) in two 
half-words, i.e. 



LEVTAB, , CHNTAB 

which the monitor will keep in the PSB. For each channel to 
be activated, the user must set up the contents of location 
CHNTAB plus the channel number to contain: 

Left half: number of priority level to which this 
channel is assigned. 

Right half: address of interrupt service routine for 
this channel. 

For any priority level specified by one or more of the above 
channel words, the user must set up the contents of location 
LEVTAB plus the priority number minus 1 to contain: 

Left half: (unused) 

Right half: location of word (in writable page) in 
which to store interrupt PC and flags. 

When an interrupt is requested, the channel word (at 
location CHNTAB plus the interrupt channel number) is 
fetched. The left half specifies the priority level to be 
used. If this left half is 0, or if the pseudo interrupt 
system for this fork is off or if an SIR has never been done 
for this fork, the system considers this fork is not 
prepared to handle a pseudo-interrupt on this channel and 
the pseudo-interrupt is changed to a fork terminating 
condition; otherwise if neither that level nor any higher 
priority level interrupt is in progress, the process PC will 
be set to the right half of the channel word. The old 
process PC will be stored as specified by the right half of 
the priority level word (at location" LEVTAB plus the 
priority number minus 1), and the process will be run. When 
the interrupt routine is completed, it should be dismissed 
with a monitor call which restores the process PC as 
specified by the right half of the priority level word, and 
the process is resumed. 
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There are some special conditions governing interrupts from 
monitor calls. However, if the service routine does not 
change the interrupt PC, all interrupts are guaranteed to be 
completely transparent, i.e., the fork will be resumed on 
de-break and will continue to do whatever it was doing. 
Note that, in general, the service routine must save any 
AC's or other temporary storage possibly in use by the 
interrupted routine. The monitor protects temporary storage 
in use by interrupted monitor routines, but the user is 
responsible for protecting all temporary storage in user 
memory. If the service routine does change the interrupt 
PC, (in any way, even the flag bits) the de-break will cause 
the fork to be restarted at the location specified by the 
interrupt PC. 

When a user program does a DEBRK, the monitor checks the 
contents of the return PC word to determine how to resume. 
If the PC word was not changed, the process will be restored 
to its state prior to the pseudo-interrupt. For example, if 
the process was dismissed waiting for I/O to complete, it 
will be restored to that state after the DEBRK. If the 
contents of the return PC word are modified, the DEBRK will 
cause the process to start running at the return PC 
location. The user can tell by looking at the User/Exec 
mode bit of the return PC word whether the process was in 
monitor code (executing a monitor call) or in user code when 
the pseudo-interrupt request was granted. That is, if B5 is 
0, the process was in monitor code; if B5 is 1, the process 
was in user code. 
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Channel Usage 

Only channels 0-5 and 24-35 may be used for terminal 
character interrupts. Many other channels are permanently 
assigned to various error conditions. Any channel may be 
used for program-initiated interrupts (IIC JSYS) . 



The details of special channel usage are summarized in 
following table: 



the 



channel 


note 


special use 


0-5 




terminal character 


6 




APR overflow (includes NODIV) 


7 




APR Floating overflow (includes 


8 




not used 


9 


(1) 


APR PDL overflow 


10 




file condition 1, EOF 


11 


(1) 


file condition 2, data error 


12 




file condition 3, (unassigned) 


13 




file condition 4, (unassigned) 


14 


(2) 


time of day 


15 


(1) 


illegal instruction 


16 


(1) 


illegal memory read 


17 


(1) 


illegal memory write 


18 


(1) 


illegal memory execute 


19 




subsidiary fork termination or 


20 


(1,2) 


machine size exceeded 


21 




trap to user (see SPACS) 


22 




reference to non-existent page 


23 




not used 


24-35 




terminal character 


notes : 


(1) 


panic channel (see below) 




(2) 


NOT IMPLEMENTED YET 



FXU) 



forced freeze 



Panic Channels 



Certain channels including APR PDL overflow, file data 
error, illegal instruction, illegal memory read, illegal 
memory write, illegal memory execute, and machine size 
exceeded, etc. are special "panic" channels in that they 
cannot be completely turned off. While they will respond 
normally to the channel on/off and read channel mask JSYS's, 
a pseudo interrupt request received on such a channel which 
has been turned off will be considered a fork terminating 
condition. 
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Pseudo Interrupt Fork Specification 

When a particular pseudo-interrupt condition arises, one 
fork will be pseudo-interrupted. It is often not obvious 
which fork should be interrupted. For example, when a 
terminal pseudo-interrupt character is typed, it is quite 
possible that several forks may be armed for that 
pseudo-interrupt condition. The following rules specify 
which fork gets the various pseudo-interrupts. 

Terminal Pseudo-interrupts 

Up to 36 terminal keys may be used to specify 
pseudo-interrupts. Each of these may be armed in multiple 
forks. When a terminal interrupt occurs, the job's fork 
structure is searched top down, depth first, and the last 
active (not frozen or terminated) fork found will receive 
the interrupt. This is usually the deepest fork with the 
oldest branches. 

When a fork is frozen, its terminal interrupts are 
effectively deactivated, although they will continue to be 
indicated in the terminal interrupt word (obtained from 
RTIW) for that fork. When the fork is resumed, the terminal 
interrupts will be automatically reactivated. 

When any fork freeze or unfreeze operation is completed, or 
when any other operation is completed which explicitly 
changes the state of the terminal interrupt word for a fork, 
the terminal interrupt word for the job (and for the 
terminal line if the job is attached) is set to be the 
inclusive OR of all of the non- frozen forks in the job. 
When searching for a fork to interrupt after receipt of an 
interrupt character, frozen forks will not be considered. 
The characters which actually cause interrupts are 
determined by masking the inclusive-OR obtained above with a 
terminal interrupt enable mask. This mask may be set/read 
with STIW and RTIW with the whole job (-5) argument. This 
word is normally -1 and thus enables all terminal interrupts 
to be activated. A zero in any position of this word will 
prevent that terminal interrupt from being concurrently 
active, but the fact that a code has been activated will be 
remembered and the activation will take effect when the mask 
is changed so as to have a one in the corresponding 
position. The function of this mask is to allow programs to 
turn off interrupt codes activated by superior forks, for 
example control-C. Reading and changing this mask word 
requires the control-C capability to be enabled. 
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Directed Pseudo- Interrupts 

The generated pseudo-interrupts are directed to specific 
fork(s) which completely specifies the fork to interrupt. 

Terminating Conditions 

If an interrupt is received on a channel which is "on", 
but the interrupt cannot be initiated because 

1. the interrupt system for the fork is off, or 

2. no SIR has been done, or 

3. no level has been assigned to the channel (i.e. 
left half of channel's word in CHNTAB is 0) 

4. the channel has been "reserved" by the superior 
fork (see SIRCM) . 

then the interrupt is considered a forced termination 
condition. In this case the fork which was to have received 
the interrupt is halted or frozen according to bit 17 of the 
capabilities word, and a fork termination interrupt is sent 
to its superior (see RFSTS) . 

Program Conditions 

Other conditions arising from program execution including 
non-error file conditions (such as EOF) , inferior fork 
termination, and APR traps (overflow, floating overflow, 
floating underflow, and no-divide) are handled as for number 
3 above except that the process continues in sequence if the 
channel is not armed. The monitor will set the actual APR 
bits in a manner appropriate to each process each time the 
monitor begins to run the process. 

Fork Termination 

When a fork terminates, only the immediate superior will be 
checked for fork termination interrupt enabled. 
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Terminal Interrupt Codes 

There are 36 codes used to specify terminal characters or 
conditions on which terminal interrupts are to be initiated. 
A process can assign a character or condition to a specific 
PSI channel with the ATI JSYS, described in this section. 



terminal 


ASCII 




code 




value 


character or condition 


(decimal) 


(octal) 












t@ or break 


1 




1 


+A 


2 




2 


+B 


3 




3 


+C 


4 




4 


+ D 


5 




5 


+E 


6 




6 


+ F 


7 




7 


+G 


8 




10 


iH 


9 




11 


tl (tab) 


10 




12 


line feed 


11 




13 


+K (vertical tab) 


12 




14 


+L (form feed) 


13 




15 


carriage return 


14 




16 


tN 


15 




17 


+ 


16 




20 


+ P 


17 




21 


+ Q 


18 




22 


tR 


19 




23 


iS 


20 




24 


tT 


21 




25 


tu 


22 




26 


tv 


23 




27 


tw 


24 




30 


+ X 


25 




31 


+Y 


26 




32 


+ Z 


27 




33 


esc (altmode) 


28 




177 


rubout 


29 




40 


space 


30 




- — 


dataset carrier off 


31- 


•35 




unassigned 



PSEUDO- INTERRUPT JSYS ' s Section 5 l-September-73 Page 



Deferred Terminal Interrupts 

Deferred terminal interrupts are optionally available. 
Previously, terminal interrupts always took effect 
immediately, i.e., upon receipt by the terminal service 
routine. Now, any enabled terminal interrupt may be 
declared "deferred" by use of STIW as described below. When 
a character which has been declared to be a deferred 
interrupt character is received, it is placed in the input 
buffer in sequence with the other characters of the input 
stream. Only when the program reaches that point in the 
input stream and attempts to read the interrupt character 
does the interrupt action occur. The interrupt character 
itself is NOT passed to the program as a data character in 
the input stream. 

The intent of this facility is to allow interrupt actions to 
occur in sequence with other actions specified by the input 
stream, when characters are typed ahead of the time that the 
programs request them. It is therefore important to 
understand the interaction of multiple forks in this 
situation. Note that the deferred interrupt occurs when any 
fork of the job executes an input JSYS (PBIN, BIN, etc.) 
which would remove the interrupt character from the input 
buffer. This fork may or may not be the one which is 
enabled for that interrupt and which will be interrupted. 
The following statements cover all of the cases: 

a. If the fork attempting the read which causes the 
interrupt is also the fork which is to be interrupted, 
then it is guaranteed that the interrupt will occur 
before any more characters are passed to the program. 

b. If the fork to be interrupted is the top fork (usually 
the EXEC) , then the interrupt will occur before any 
more characters are passed to the program unless a 
second fork is also attempting to read from the same 
source (normally an anomalous condition) . 

c. If neither of these cases apply, then the fork doing 
terminal input will continue to run and may succeed in 
reading one or more characters before the interrupt can 
take effect. This is unavoidable since the input fork 
and the interrupted fork will logically be running in 
parallel. 

An otherwise deferred interrupt character will have 
immediate effect if two of that character are received with 
no intervening characters. There is no element of time 
involved here, rather it is required only that the character 
now being received is the same as the last previous 
character received and that the character is a deferred 
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interrupt character. When this event occurs, the terminal 
input buffer is automatically cleared (simulated CFIBF) . 
Note also that the system maintains a separate one-character 
buffer to detect this situation, so that it will work even 
if the input buffer is otherwise full. 



Process Ps eudo- Interrupt Tables 

Before using the PSI system, a process must set up the 
following two tables, and declare their locations with SIR. 



LEVTAB 



Three words. Left halves unused, right half of word 
points to word in process's address space in which to 
store the return PC word for level 1, right half of 
word 1 is for level 2, etc. 



CIINTAB 



Indexed by channel number. Left half of each word 
contains priority level (1, 2, or 3) for that channel. 
Right half contains address of PSI routine for that 
channel. 
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SIR JSYS 125 

Sets up the pseuclo- interrupt table addresses for a process 

ACCEPTS IN 1: a fork handle 

2: LH: the virtual address of LEVTAB 
RH: the virtual address of CHNTAB 

SIR 

RETURNS +1: always, places the contents of accumulator 2 
in a word in the PSB. 

Generates an illegal instruction pseudo- interrupt on error 
conditions listed below. 

SIR ERROR MNEMONICS: 

SIRXl: address of LEVTAB or CHNTAB < 20 

FRKHXl: illegal fork handle 

FRKHX2 : cannot be used to manipulate a superior fork 

FRKHX3: cannot be used to manipulate multiple forks 
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RIR JSYS 144 

Read pseudo-interrupt table addresses for a process, i.e., 
the channel and level table addresses as set by SIR. 

ACCEPTS IN 1: a fork handle 

RIR 

RETURNS +1: always with addresses in 2: 

LH: LEVTAB address 
RH: CHNTAB address 

Returns if no SIR has been done for designated process. 
This JSYS allows several independent programs to reside in 
one fork and share interrupt tables. 

Error conditions 

FRKHXl: illegal fork handle 

FRKHX2: cannot be used to manipulate a superior fork 

FRKHX3: cannot be used to manipulate multiple forks 



EIR JSYS 126 

Enables the pseudo-interrupt system for a process 

ACCEPTS IN 1: a fork handle 

EIR 

RETURNS +1: always 

Generates an illegal instruction pseudo-interrupt on error 
conditions listed below. 



EIR ERROR MNEMONICS: 

FRKHXl: illegal fork handle 

FRKHX2: cannot be used to manipulate a superior fork 
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SKPIR JSYS 127 

Tests the pseudo interrupt system to see if it is enabled 
i.e., skip if pseudo interrupt system on 

ACCEPTS IN 1: a fork handle 

SKPIR 

RETURNS +1: pseudo interrupt system off 
+2: pseudo interrupt system on 

Generates an illegal instruction pseudo- interrupt on error 
conditions listed below. 



SKPIR ERROR MNEMONICS: 

FRKHXl: illegal fork handle 

FRKHX2: cannot be used to manipulate a superior fork 

FRKHX3: cannot be used to manipulate multiple forks 
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DIR JSYS 130 

Disables the pseudo- interrupt system for a process 

ACCEPTS IN 1: a fork handle 

DIR 

RETURNS +1: always 

If pseudo-interrupt requests are generated while the 
pseudo-interrupt system is off, they are remembered and will 
take when the pseudo-interrupt system is turned back on 
unless an intervening CIS is issued. Note that once the +C 
terminal key gets assigned to a channel, it will always 
cause a pseudo-interrupt which cannot be disabled by DIR but 
can be disabled by shutting off the channel in the fork 
assigned to +C or by the monitor during 
non-pseudo-interruptible periods. DIR has no effect on 
pseudo-interrupts on panic channels (i.e., they will behave 
as though the pseudo-interrupt system were enabled in that 
fork) . 

Generates an illegal instruction pseudo-interrupt on error 
conditions listed below. 

DIR ERROR MNEMONICS: 

FRKHXl: illegal fork handle 

FRKHX2: cannot be used to manipulate a superior fork 
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AIC JSYS 131 

Activate specified channels 

ACCEPTS IN 1: a fork handle 

2: a 36-bit word, B0 on means 

activate channel 0, Bl on means 
activate channel 1 , . • . 

AIC 
RETURNS +1: always 

Generates an illegal instruction pseudo-interrupt on error 
conditions listed below. 

AIC ERROR MNEMONICS: 

FRKHXl: illegal fork handle 

FRKHX2: cannot be used to manipulate a superior fork 

FRKHX3: cannot be used to manipulate multiple forks 



IIC JSYS 132 

Initiates pseudo-interrupts on specified channels in a fork 

ACCEPTS IN 1: a fork handle 

2: a 36-bit word, B0 on means initiate 
pseudo-interrupt on channel 0, Bl on means 
initiate pseudo-interrupt on channel 1,... 

IIC 

RETURNS +1: always 

Generates illegal instruction pseudo-interrupt on error 
conditions below. 

IIC ERROR MNEMONICS! 

FRKHXl: illegal fork handle 

FRKHX3: fork handle cannot reference multiple forks 
for this JSYS 
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DIC JSYS 133 

Deactivate specified channels 

ACCEPTS IN 1: a fork handle 

2s a 36-bit word, B0 on means deactivate channel 
0, Bl on means deactivate channel 1,... 

DIC 

RETURNS +1: always 

A deactivated channel completely ignores pseudo-interrupt 
requests made of that channel except for IIC JSYS's to that 
channel or some exceptions noted under DIR. 

Generates an illegal instruction pseudo-interrupt on error 
conditions listed below. 

DIC ERROR MNEMONICS; 

FRKHXls illegal fork handle 

FRKHX2 : cannot be used to manipulate a superior fork 

FRKHX3: cannot be used to manipulate multiple forks 



RCM JSYS 134 

Read channel-activated word-mask 

ACCEPTS IN 1; a fork handle 

RCM 

RETURNS +1: always, 36 -bit word in 1 with B0 on meaning 
channel activated, Bl on meaning channel 1 
activated, • • • 



Generates an illegal instruction pseudo-interrupt on error 
conditions listed below. 



RCM ERROR MNEMONICS: 

FRKHXl: illegal fork handle 

FRKHX2: cannot be used to manipulate a superior fork 

FRKHX3: cannot be used to manipulate multiple forks 
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RWM JSYS 135 

Read Waiting Channel interrupts word mask 

ACCEPTS IN 1: a fork handle 

RWM 

RETURNS +1: always, 36-bit word in 1 with B0 on meaning 
channel interrupt waiting, Bl on meaning 
channel 1 interrupt waiting, etc. The status 
of the pseudo-interrupts in progress is 
returned in 2, where Bl means level 1 in 
progress, B2 means level 2 in progress, etc. 

Generates an illegal instruction pseudo- interrupt on error 
conditions listed below. 



RWM ERROR MNEMONICS: 

FRKHXl: illegal fork handle 

FRKHX2: cannot be used to manipulate a superior fork 

FRKHX3: cannot be used to manipulate multiple forks 
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SIRCM JSYS 142 

Set Inferior Reserved Channel Mask. 

ACCEPTS IN 1: inferior fork handle 

2: mask bit on for reserved channels 

SIRCM 

RETURNS +1: always 

SIRCM must be given only for inferior forks. PSI channels 
with the corresponding mask bit on will never break to the 
inferior fork, but rather will cause termination or 
freezing. This provides a facility for a superior to 
monitor an inferior (e.g., illegal instructions, memory 
traps) regardless of how the inferior uses the interrupt 
system. 

SIRCM ERROR MNEMONICS: 

FRKHXl: illegal fork handle 

FRKHX2: cannot be used to manipulate a superior fork 

FRKHX3: cannot be used to manipulate multiple forks 
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Read Inferior Reserved Channel Mask. 

ACCEPTS IN 1: fork handle, inferior or self 

RIRCM 
RETURNS +1: always with 

2 : reserved channel mask for designated fork 

Note that a fork may read but not set its own reserved 
channel mask. 

RIRCM ERROR MNEMONICS: 

FRKHXl: illegal fork handle 

FRKHX2: cannot be used to manipulate a superior fork 

FRKHX3: cannot be used to manipulate multiple forks 
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DEBRK JSYS 136 

Dismiss current pseudo- interrupt level in progress and 
resume process in sequence, i.e., debreak 

DEBRK 

Normally returns to the location specified by the PC stored 
in the priority level PC word. 

RETURNS +1: if no pseudo-interrupt is currently in progress 



ATI JSYS 137 

Assigns a terminal code to a channel 

ACCEPTS IN 1: LH: terminal code 

NOT an ASCII code; see introduction 
RH : channel number 

ATI 

RETURNS +1: always 

If there is no controlling terminal (i.e., the job is 
detached) , the assignments are remembered and will be in 
effect when a terminal becomes attached. ATI also sets the 
corresponding bit in the fork's terminal interrupt mask (see 
STIW/RTIW) . 

Generates an illegal instruction pseudo-interrupt on any 
error conditions shown below. 

ATI ERROR MNEMONICS: 

TERMXls illegal to associate this particular terminal 
code with pseudo-interrupt channel 

ATIXl: illegal channel number for terminal code 
assignment (only 0-5, 24-35 legal) 

ATIX2: attempt to assign tC but this special 
privilege not enabled for this process 
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DTI JSYS 140 

Deassigns terminal code 

ACCEPTS IN 1: terminal code 

NOT an ASCII code; see introduction 

DTI 

RETURNS +1: always 

Generates an illegal instruction pseudo-interrupt on any 
error conditions shown below 

DTI ERROR MNEMONICS: 

TERMXl: illegal to associate this particular terminal 
code with a pseudo-interrupt channel 

DTIXl: this terminal code was never assigned to this 
process 
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STIW JSYS 174 

Set Terminal Interrupt Word. This JSYS sets the mask word 
for any specified fork or the whole job, thus determining 
whether that fork/ job will receive an interrupt for each of 
the 36 terminal interrupt codes. If the bit in the job mask 
for a particular terminal code is off, that character will 
remain in the input stream. If the bit is on, the character 
will not be placed in the input stream, and the fork 
structure will be searched for forks having the code 
enabled. The lowest such fork found will be interrupted. 
If no fork is found, the bit is cleared from the job mask 
and the character is lost. 

Each STIW done on a specific fork will cause the job mask to 
be updated for the bits changed in that fork . 

Note that STIW can turn particular terminal codes on and off 
for a particular fork without changing the interrupt channel 
assignment that each code may have. ATI must be used to set 
the channel assignment. 

ACCEPTS IN 1: B0 on, use 3 as below 
B0 off, ignore 3 
RH: a fork handle or -5 for whole job 

2: Mask for terminal codes, bit N a 1 means 
terminal code N enabled 

3: Deferred interrupt mask 

(ignored unless B0 of 1 is on 

and RH of 1 names a specific fork) 

STIW 

RETURNS +1: always 

A 1 in any bit of the deferred interrupt mask causes the 
corresponding character to be deferred. If more than one 
fork has enabled a particular interrupt character, it will 
be deferred if ANY of the forks have declared it to be 
deferred. The AC3 argument is ignored, and no change is 
made to the deferred interrupt mask, if the sign bit of ACl 
is off or if the right half of ACl is not a specific fork 
designator. 

STIW ERROR MNEMONICS: 

FRKHXl: illegal fork handle 

FRKHX2 : cannot be used to manipulate a superior fork 

FRKHX3: cannot be used to manipulate multiple forks 
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RTIW JSYS 173 

Read Terminal Interrupt Word. Reads mask word for any 
specified fork or whole job. 

ACCEPTS IN 1: B0 on: return AC 3 

B0 off: do not change AC3 

RH: a fork handle or -5 for whole job 

RTIW 

RETURNS +1: always, with 2: terminal interrupt mask 

3: Deferred interrupt mask 

if B0 of 1 is on and RH of 1 specifies a 

particular fork (not -5) 

RTIW ERROR MNEMONICS: 

FRKHXl: illegal fork handle 

FRKHX2: cannot be used to manipulate a superior fork 

FRKHX3: cannot be used to manipulate multiple forks 



CIS JSYS 141 

Clear Interrupt system. Clears all breaks in process and 
waiting breaks. 

CIS 
RETURNS +1: always 
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RWSET 



JSYS 176 



Release Working Set 

Removes all of a process's pages from its working set. 

Operation is invisible to the user, but allows the pages to 

move to secondary storage; they will not be preloaded the 
next time the process is swapped in. 



RWSET 



RETURNS 



+1: always 



GTRPW 



JSYS 171 



Get trap words. This JSYS allows a program to retrieve 
information about a previous memory read, write or XCT trap. 



ACCEPTS IN 1: fork handle 



GTRPW 



RETURNS +1: always, with: 

1: Trap status word from last memory trap 
2: Write data (if any) 



This information allows a program to determine the exact 
cause of a memory trap and/or the effective virtual address 
that caused the trap. This information is sufficient to 
enable the program to continue, if desired, when the cause 
of the trap has been removed. 

If there have been no memory traps, is returned in 1. 
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Pager Traps 

A paging trap will occur whenever one of the following 
events happens : 

(1) The trap bits in the process page table force a 
trap. 

(2) The addressed page (or indirecting page table) is 
not in core. 

(3) An illegal condition is detected. 

(4) The Core Status Table entry for an addressed page 
contains an age with the three highest bits = 0. 



When one of the above conditions happens, the pager first 
stores the cause and location of the trap into the P.S.B. 
at location 571 octal. The format of this word is shown 
below. Then, if the APR operation in progress was a write, 
it stores the data into the P.S.B. Finally, it forces the 
APR to execute the trap routine. 

The arrangement of the Trap Cause field was chosen so that 
decoding of the cause could be easily accomplished by the 
JFFO instruction. 

If the trap word indicates that a read or execute request 
was present, the saved PC points to the instruction that 
caused the pager trap. Otherwise, the saved PC has been 
incremented and the previous (write) instruction must be 
simulated by moving the saved trap data to the virtual 
address which caused the trap (in the right half of the trap 
word) before resuming. 



Interpretation of TRAP Word 

Bits 0-8, trap cause are decoded as follows: Bits and 
define one of four groups each defined below: 
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Group 0: TSR 0,1 = 00 

Bit Meaning if ON 

2 AGE » 00X 

3 AGE = 02X as read from 

4 AGE = 04X C.S.T. 

5 AGE = 06X 

6 Monitor After- Loading A.R. trap 

Group 1: TSR 0,1 = 01 

BIT Meaning if on 

3 Shared not in core 

4 Page table not in core (P.T.2) 

5 2nd indirect, private not in core (P.T. 3) 

6 Indirect shared not in core (P.T.2 or P.T. 3) 

7 Indirect page table not in core (P.T. 3) 

8 Excessive Indirect pointers (>2) 

Group 2: TSR 0,1 = 10 

Bit Meaning if on 

2 Private Not in core 

3 Write copy trap (bit 9 in P.T.) 

4 User trap (bit 8 in P.T.) 

5 Access trap (P.T. bit 12 = or bits 10-11=3) 

6 Illegal Read or Execute 

7 Illegal Write 

8 Address Limit Register Violation or P.T. bits 
0,1=3 (illegal format) 

Group 3: TSR 0,1 = 11 

Bit Meaning if on 

2 Private Not in core 

(in 3 Write copy trap (bit 9 in P.T.) 

2nd 4 User trap (bit 8 in P.T.) 

or 5 Access trap (P.T. bit 12 = or bits 10-11=3) 

3rd 6 Illegal Read or Execute 

page 7 Illegal Write 

table) 8 Address Limit Register Violation or P.T. bits 
0,1=3 (illegal format) 
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Bits 9-17 are decoded as follows: 
Bit Meaning if on 

9 Parity Error 

10 Non-EX-MEM 

11 KEY ( KEY cycle in progress— console Examine, 

XCT, or deposit switch pushed) 

12 PI (Priority Interrupt cycle in progress) 

13 I (Indirect acTdress sequence in progress) 

14 R (Read request) 

15 W (Write request) 

16 E (Execute request) 

17 EM TExec Mode) 

18 Effective Address of Request 

Bits 18-35 are the virtual address which caused the trap. 
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Section 5 Index 
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Terminal interrupt codes ... 8 
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SPECIAL CAPABILITIES 



INTRODUCTION 



There is a set of special capabilities in the TENEX 
system which is limited to certain processes. Each 
capability is separately protected and activated, and 
includes privileges such as the abilities to look at and/or 
change the running monitor, change process capabilities, and 
allow a fork to handle control-C interrupts from lower 
forks. These capabilities are assigned on a per process 
basis, and the status of each capability is kept in words 
assigned in the PSB. The number of capabilities is limited 
to 36, and two words are used to store the status of 
capabilities. For each capability there is a bit in the 
first word which is 1 if the capability is available to the 
process. In the corresponding bit in the other word, a 1 
indicates that the capability is currently enabled. This 
allows the user to protect himself against accidental use 
without giving up the capability. 

New forks are created upward with no special 
capabilities or the capabilities of the creating fork. 
Capabilities may be passed down from higher level forks 
which have the capability available. Most capabilities 
relate to system functions and may be passed from superior 
to inferior fork only if the superior itself has the 
capabilities. Some capabilities relate inferior to superior 
and so may be given to an inferior whether or not available 
in the superior. 



Note: page number 2 is reserved for expansion of this 
introduction 
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this page to be used for future growth 
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FORK FREEZING 

With reference to JSYS's that control whether or not a fork 
can execute instructions (FFORK, RFORK, HFORK, SFORK, 
SFRRKV) : 

A fork may be independently frozen in two ways : 

1. upon explicit request of its superior, 

2. because its superior has been frozen. 

We refer to these as direct and indirect freezing, 
respectively. When any fork is directly frozen, all of its 
inferiors are indirectly frozen at the same time. A fork 
may be both directly and indirectly frozen if it was 
directly frozen and its superior was subsequently also 
frozen. Explicitly unfreezing a fork will clear the direct 
freeze from it and indirect freeze from all of its inferiors 
unless a fork with a direct freeze is encountered. The 
indirect unfreeze will be cleared from that fork but not 
from any of its inferiors. The logical effect of this is 
that the explicit freezing of any fork will prevent any of 
its inferiors from running, and the unfreezing of such a 
fork will automatically resume the inferiors. 

This produces the proper effect for jobs with several levels 
of controlling forks, for example, an EXEC running an IDDT 
running a test program. If the IDDT has frozen the test 
program (running in an inferior fork) , and the user 
subsequently does a control-C and CONTINUE or START or 
REENTER) , the IDDT will be resumed, but the test program 
will correctly remain frozen. 

FFORK and RFORK may name a particular inferior fork or 
supply -4 as an argument to mean all immediate inferiors. 
That is, -4 will freeze/unfreeze all immediate inferiors, 
and forks below the immediate inferiors will be indirectly 
affected as described above. Freeze/unfreeze is never legal 
on any fork which is not inferior to the executing fork. 

SFORK, SFRKV, and HFORK, will change the state of a fork as 
appropriate, but if the fork was frozen, it will remain 
frozen and not begin operating in the new state until 
resumed. For example, a frozen fork may have its PC changed 
by action of SFORK, but the fork will not commence running 
at that PC until it is unfrozen. Similarly, if HFORK is 
executed on a frozen fork, the fork will continue to be 
frozen, but when it is resumed it will then be in the halted 
state. The changed status is always reflected in the 
information returned by RFSTS, i.e. in the former example 
it would show the changed PC, and in the latter example, it 
would return the halted code in the status word. 
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bit mnemonic 



B0 

Bl 
B2 
B3 
B4 
B5 



B9 
B17 



CTRLC 



LOG 



ASSIGNED CAPABILITIES 



B0-8 Job Capabilities 

process can activate terminal key +C for 
pseudo-interrupt 

process can examine monitor tables with GETAB 

process can map the running monitor 

process can execute protected log functions 

process can map privileged pages of files 

process can control special devices like 
DP, RTI 

NOT IMPLEMENTED YET 

B9-17 Capabilities which can be given to 
an inferior whether or not the superior 
itself has them. Of these, B14-17 may 
not be changed by a process for itself. 

Process can do map operations on superior 

Unprocessed PSI's cause freeze instead 
of termination. 



B18 WHEEL 

B19 OPER 

B20 COMF1 

B21 MAINT 



B18-35 User Capabilities 

user is a wheel 

user has operator privileges 

user can see system confidential information 
(e.g. error printouts) 

user can HALT TENEX 

This capability is sufficient for the 
privileged JSYS's USRIO, HSYS , 
LITES, and LOGOUT. 
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RPCAP JSYS 150 

Reads process capabilities words 

ACCEPTS IN Is a fork handle 

RPCAP 

RETURNS +1: always with special capabilities possible 
in 2, special capabilities enabled in 3 

Generates illegal instruction pseudo interrupt on any error 
conditions below. 

RPCAP ERROR MNEMONICS: 

FRKHXl: illegal fork handle 



EPCAP JSYS 151 

Enables process capabilities 

ACCEPTS IN 1: a fork handle 

2: special capabilities possible 

3: special capabilities to enable 

EPCAP 

Word 2 is ignored if the fork handle points to this process. 
Bits 0-8 and 18-35 of word 2 are "AND M ed with the special 
capabilities possible for this fork before being passed down 
to a lower fork. (The "AND" just reduces capabilities, does 
not generate errors.) 

RETURNS +1: always 

Generates illegal instruction pseudo-interrupt on error 
conditions below: 

EPCAP ERROR MNEMONICS: 

FRKHXl: illegal fork handle 

FRKHX2: this JSYS cannot be used to manipulate a 
superior fork 



FORKS AND CAPABILITIES Section 6 l-September-73 Page 



FORKS AND SCHEDULING 



INTRODUCTION 



These JSYS's deal with the establishing and 
interrogating of the fork structure of the job. 



Another JSYS related to forks (and other things) is 
RESET, which is described in section 2. See also PMAP, 
RMAP, RPACS, and SPACS in section 2 for controlling fork 
memory maps, and GPJFN and SPJFN for controlling primary I/O 
files, GTRPN (section 5) and GTRPI (section 3) provide 
information about the paging activities of a fork. 
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CFORK JS'YS 152 
Creates a fork inferior to this process 
ACCEPTS IN 1: left half 

BIT VALUE MEANING 

1 set map as indirect to current fork 
set map to empty (all 0) 

1 1 set spec. cap, to same as current 

fork 
set spec, cap. to 

2 - not used 

3 1 set startup AC's from block of 20(8) 

words whose address is in 2 
set startup AC's to 

4 1 set PC to C(ACl) (RH) and start fork 
do not start fork 

right half: PC value 

2: (optional) virtual address of 20(8) word block 

CFORK 

RETURNS +1: unsuccessful, error number in 1 

+2: successful, relative fork handle in 1 

The new fork receives the same primary input and output 
JFN's as the current fork, however primary input and/or 
output files may be changed with SPJFN, section 2. 

The bit option causes the inferior to see the same address 
space as that of the creator. Note that the pages are not 
shared; changes in the inferior's page map will not be seen 
by the superior. 

CFORK ERROR MNEMONICS: 

FRKHX6: all relative fork handles used up 

CFRKX2: illegal to start a fork unless bit is set 

with CFORK 
CFRKX3: no room in system 
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KFORK JSYS 153 
Kills one or more Forks 
ACCEPTS III 1: a fork handle 

KFORK 

Generates an illegal instruction pseudo-interrupt on error 
conditions below. , 

Killing a fork releases all truly private memory acquired by 
the fork and its PSB; it also passes back any terminal key 
assignments which were acquired from another fork and 
releases JFM's fork has created. 

KFORK ERROR MNEMONICS: 

FRKHXl: illegal fork handle 

FRKHX2: this JSYS cannot be used to manipulate a 

superior fork 
KFRKXl: this JSYS cannot kill the top level fork 
KFRKX2: suicide not legal 
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SPLFK JSYS 314 

SPLice ForK structure. 

Accepts in 1: fork handle of new superior 

2 : fork handle of fork to become inferior 

SPLFK 

Returns +1: unsuccessful, error number in 1 
+2: successful, a handle in 1 

If successful, a handle is returned which may be used by the 
new superior fork (ACl) to refer to its new inferior (AC2) . 

Restrictions: The "new superior" must be either the fork 
performing the SPLFK or an inferior of it. The "new 
inferior" must be strictly an inferior of the executing 
fork. The "new superior" must not be the same fork as the 
"new inferior", nor may the "new superior" be an inferior of 
the "new inferior". The new inferior and all its inferior 
forks will be frozen after the SPLFK. 

SPLFK ERROR MNEMONICS: 

SPLFK 1: new superior not self or inferior 

SPLFK2: new inferior not already inferior 

SPLFK3: new inferior not inferior to new superior 

FRKHXl: illegal fork handle 
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RFORK JSYS 155 

Resumes one or more forks which had been frozen (by melting 
them) 

ACCEPTS IN 1: a fork handle 

RFORK 

RETURNS +1: always 

This does nothing if the referenced fork(s) were not frozen. 

Generates an illegal instruction pseudo-interrupt on error 
conditions below. 

RFORK ERROR MNEMONICS: 

FRKIIX1: illegal fork handle 

FRKHX2: this JSYS cannot be used to manipulate a 
superior fork 
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RFSTS JSYS 156 
Reads fork status 
ACCEPTS IN 1: a fork handle 

RFSTS 
RETURNS +1: always; status word in 1, PC in 2 

If the handle is in legal form but unassigned in the current 
process, RFSTS returns normally with -1 in the LH of 1. 

Generates illegal instruction PSI on error conditions below 
RFSTS ERROR MNEMONICS: 

FRKHXl: illegal fork handle 

FRKHX3: fork handle cannot reference multiple forks 
for this JSYS 



FORK STATUS WORD 
LEFT HALF 

(sian bit on means frozen, off melted) 

runable 

1 dismissed for I/O, 

2 dismissed by voluntary fork termination 
(HFORK or HALTF) or never started 

3 dismissed by forced fork termination 

4 dismissed waiting for another fork to terminate 

5 dismissed for a specific amount of time 
(* currently returns status 1) 

6 breakpoint (* currently returns status 2) 

RIGHT HALF 

The pseudo interrupt channel # which caused the forced 
fork termination 
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Fork States 



SFORK at (backuped) PC 
before the RFORK in 
"PROCEED" command? 



PC points at . 
instruction +1?| \ 



CODE STATUS 



PC- 5 

USERMODE 



EXAMPLE 





Running 





Interrupt out of long JSYS 
like RESET, JFNS 


YES 


NO 





1 


Normal Interrupt 


NO 


NO 




10 WAIT 





Interrupt out of PBIN, 
GTJFN,JOUT 


YES 


NO 


1 


1 












2 


Voluntary 
Termination 





HFORK , HALTF , ( BPT ) * 


YES 


YES 


1 












3 


Involuntary 
Termination 





Illegal Instruction JRST 4, 


YES 

If write 


YES 




1 


Illegal Memory Reference 


trap 


YES 


4 


FORK 
WAIT 





Interrupt out of WFORK 


YES 


NO 


1 














Dismissed 
For At 





Interrupt out of DISMS 


YES 


NO 


5** 


1 












6* 


At a 
Breakpoint 





BPT 


YES 


YES 


1 













BPT currently reports a status code of 2 and must be 
handled as a special case. 



** DISMS currently reports a status of 1. 



Plans exist to implement codes 5 and 6. 
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SFORK JSYS 157 

Starts a fork 

ACCEPTS IN 1: a fork handle 

2: virtual address (for starting PC) 

SFORK 

RETURNS +1: always, if fork was frozen in any manner, 
SFORK simply changes the fork PC; the fork 
must be resumed by RFORK 

Generates illegal instruction pseudo-interrupt on error 
conditions below. 

SFORK ERROR MNEMONICS: 

FRKHXl: illegal fork handle 

FRKHX2: this JSYS cannot be used to manipulate a 

superior fork 
FRKHX3: fork handle cannot reference multiple forks 

for this JSYS 
FRKHX4: fork already running 
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SFACS JSYS 160 

Sets Fork AC'S 

ACCEPTS IN 1: a fork handle 

2: pointer to a 20(8) word table in address space 
of this process containing values to be set 
into AC's of specified fork 

SFACS 
RETURNS +1: always 

Specified fork must not be running. 

Generates illegal instruction pseudo interrupt on error 

conditions below. 

SFACS ERROR MNEMONICS: 

FRKHXl: illegal fork handle 

FRKHX2: this JSYS cannot be used to manipulate a 

superior fork 
FRKHX3: fork handle cannot reference multiple forks 

for this JSYS 
FRKHX4: fork already running 
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RFACS JSYS 161 

Read Fork AC'S 

ACCEPTS IN 1: a fork handle 

2: a pointer to a 20(8) word table in address 
space of this process where the AC values of 
the specified fork will be stored. 

RFACS 

RETURNS +1: always 

Generates illegal instruction pseudo-interrupt on error 
conditions below. 

RFACS ERROR MNEMONICS: 

FRKHXl: illegal fork handle 

FRKHX2: this JSYS cannot be used to manipulate a 

superior fork 
FRKHX3: fork handle cannot reference multiple forks 

for this JSYS 
FRKHX4: fork already running 
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HFORK JSYS 16 2 

Halts one or more forks 

ACCEPTS IN 1: a fork handle 

HFORK 

RETURNS +1: always, just sets PC to this value if HFORK 
halted this process 

Sets status word(s) for addressed fork(s) bits 1-17 to 2. 

Note: See HALTF to halt current fork with no arguments (and 
thus no clobbered AC's). 

Generates an illegal instruction pseudo-interrupt on error 
conditions below. 

HFORK ERROR MNEMONICS: 

FRKHXl: illegal fork handle 

FRKHX2: this JSYS cannot be used to manipulate a 

superior fork 
FRKHX5: addressed fork(s) was (were) already halted 



WFORK JSYS 16 3 

Waits for one or more forks to terminate (voluntarily or 
involuntari ly ) 

ACCEPTS IN 1: a fork handle 

WFORK 

RETURNS +1: when one or more of the addressed forks 
terminate 

WFORK for multiple fork handles NOT IMPLEMENTED YET. 
Generates an illegal instruction pseudo-interrupt on error 
conditions below. 

WFORK ERROR MNEMONICS 



FRKHXl: illegal fork handle 

FRKHX2: this JSYS cannot be used to manipulate a 
superior fork 
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GFRKH JSYS 164 

Gets a fork handle useable in this process for a fork 
currently not known to this process 

ACCEPTS IN 1: a fork handle of some fork which does have a 
handle (call it H) on the desired fork 

2: the handle H, must be 400001-400030 and must 
point to an existent fork 

GFRKH 

RETURNS +1: unsuccessful, error number in 1 

+2: successful, a useable handle H* in 1 

GFRKH ERROR MNEMONICS: 

FRKHXl: illegal fork handle 

FRKHX2: this JSYS cannot be used to manipulate a 

superior fork 
FRKHX3: fork handle cannot reference multiple forks 

for this jsys 
GFRKXl: the handle H was illegal 
FRKHX6: all relative fork handles used up 



RFRKH JSYS 16 5 
Releases a fork handle or all fork handles in this process 
ACCEPTS IN 1: a fork handle 

RFRKH 
RETURNS +1: always 
RFRKH ERROR MNEMONICS: 
FRKHXl: the handle in 1 was illegal 
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GFRKS JSYS 16 6 

Gets fork structure from a given starting point downward 
NOT IMPLEMENTED YET 

ACCEPTS IN 1: the fork handle of the starting point 

in 2: LH: 

B0 on - get relative fork handles for each 
fork in structure 

Bl on - get status for each fork in structure 



RH: 

virtual address of start of table in address 
space of this process where the structure will 
get stored 

GFRKS 

RETURNS +1: always 
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Table format 



2(3) words 
per entry 



optional => 



******************************************* 

* * * 

* parallel * inferior * 

* pointer * pointer * 

* * * 
******************************************* 

* * * 

* superior * fork handle * 

* pointer * or if B0 word 2 * 
* 
* 

* 

* * process * 

* * * 
******************************************* 

* * 

* status word * 

* * 
******************************************* 



* was off or when no* 

* more fork handles * 

* left for the * 

* process 



Note: "pointers" in above table are core 
addresses of other table entries, or 
if no such structure. 



Generates illegal instruction pseudo-interrupt 
on error conditions below. 

GFRKS ERROR MNEMONICS: 



FRKHXl: 
FRKHX3: 



illegal fork handle 

fork handle cannot reference multiple forks 

for this JSYS 
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DISMS JSYS 167 

Dismiss this process for at least the specified amount of 
time • 

ACCEPTS IN 1: a number of milliseconds for which the process 
is to be dismissed 

DISMS 

RETURNS +1: when the elapsed time is up 

The time resolution is obviously limited to the clock 
in use on the PDP-10. 



HALTF JSYS 170 

Halts this process 

HALTF 

Sets PC to caller+1 and halts process. Sets status word for 
this process bits 1-17 to 2. 

If an attempt to execute a HALTF at the top level is made 
without WHEEL or OPER special capability enabled, the top 
level process is replaced by the TENEX EXEC which is started 
at its initialization entry. 



BPT JSYS 304 
Breakpoint 



Implementation incomplete. Current behavior is identical to 
HALTF . 
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WAIT JSYS 306 

Dismiss this process indefinitely (i.e., wait) - does not 
return. However, if the pseudo-interrupt system is enabled, 
the process can be interrupted out of the WAIT. On DEBRK, 
the process continues WAITing for the next interrupt. 
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SAVE AND ENVIRONMENT DUMP FILES 



INTRODUCTION 



TENEX handles SAVE files of three forms: 10/50 SAVE 
format, regular (non-sharable) TENEX SAVE files, and TENEX 
sharable SAVE files. The latter can exist on DSK: only. 



TENEX SAVE FORMAT 

IOWD length, location 
data 

IOWD length, location 
data 



10/50 SAVE FORMAT 

IOWD length, location 
I data 



E: XWD length of entry 

vector, pointer to first 
entry 

(possible MISC other 
words from PSB) 

The entry vector is in the 
address space of the SAVE 
file 



E: JRST start - start 

JRST reenter - reenter 



For a 10/50 format SAVE 
file, entry vector 
relative position 

=> use JOBSA (120) 

1 => use JOBREN (124) 
all other relative 
positions illegal 



Note: Files actually SAVed by a 10/50 monitor have the 
contents of location 41 shifted to. location 122. After 
GETing such a file on TENEX, it may be necessary for the 
user to move this word to location 41. 
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TENEX Shared File Format 



SSAVE creates files which contain sequences of pages, 
whereas SAVE stores words. An SSAVE file has two parts: the 
actual pages containing data (pages 2,3 ... of the file), 
and pages and 1 which contain length, mapping information 
and the entry vector for use when a GET is done. Usually 
all of the control information can be held in just page of 
the file. Thus, most SSAVE'd files will not have a page 1. 



Page (and 1 if needed) : 
Word 0: 1000, ,N 



N is the number of data pages 



Word 1 
Word 2 
Word 3 



Word N: 



Word N+l 



Mapping information 



LENGTH, , ADDRESS 



Pages 2, 3, 4, ... 



TENEX entry vector 
Data Pages 



Each mapping information word has three 
used in the GET JSYS to set up a PMAP: 



fields which are 



bits 0-8; 
bits 9-17: 
bits 18-35: 



Access bits, left 9 bits of AC3 in PMAP 
Fork page, AC 2 of PMAP 
File page, ACl of PMAP 
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GET 



JSYS 200 



Gets a SAVE file, copying or mapping it into the fork as 
appropriate. Works with TENEX and 10/50 SAVE formats and 



TENEX sharable SAVE format, 
from file. 



Updates fork*s entry vector 



ACCEPTS IN 1: LH : 
RH: 



fork handle 

JFN 



GET 



RETURNS 



+1; always 



When a GET is performed on an SSAVE file, pages from the 
file are mapped into the fork, and the previous contents of 
the map are removed. GET does not disturb existing pages 
for which the file contains no data, but if the file 
contains data for part of a page only, the rest of the page 
is zeroed. 

When a GET is performed on a SAVE file, individual words are 
written into the fork, however, SAVE files usually do not 
contain words. Thus, GETing a SAVE file will never clear 
memory . 

GET never loads the accumulators. 

Generates an illegal instruction PSI on error conditions 
below. Can cause several PSIs or fork termination on 
certain file conditions. 



GET ERROR MNEMONICS: 



FRKHXl: 
FRKHX2: 
FRKHX3: 
GETXl: 
GETX2 : 



SSAVXl: 



illegal fork handle 

cannot be used to manipulate a superior fork 

cannot be used to manipulate multiple forks 

illegal SAVE format 

no room in Special Pages Table, 

can only occur with a TENEX sharable SAVE 

file. 

SSAVE file not from DSK: 

All file errors can occur. 
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SFRKV 
Starts fork usincr entry vector 
ACCEPTS IN 1: a fork handle 



JSYS 201 



2: a relative position in entry vector to use for 
start address (0-n) . is always primary 
start address, 1 is reenter address. 



SFRKV 



RETURNS 



+1: alwavs 



The fork is started at the indicated position IN the entry 
vector, NOT at the location of which the entry vector word 
points to. 

If the process has 10/50 format entoy vector (JRST in LH) , 
for example because it was GETed from a 10/50 format SAVE 
file, entry vector relative position means use contents of 
JQBSA=120 as start address, and 1 means use contents of 
JOBREN=12 4 as reenter address. 

Generates illegal instruction PSI on error conditions below. 



SFRKV ERROR MNEMONICS: 



FRKIIXl: 
FRKHX2: 
FRKHX3: 
FRKIIX4: 
SFRVXl: 



illegal fork handle 

cannot be used to manipulate a superior fork 

cannot be used to manipulate multiple forks 

fork already running 

illegal relative position 
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SAVE 



JSYS 202 



SAVEs (non-sharably) areas of a process. Notes whether 
process is TEMEX or 10/50 format by its entry vector word 
(JRST in LH for 10/5 format) and appropriately formats last 
word(s) of SAVE file. 



ACCEPTS IN 1: LH: 
RH: 



fork handle 

JFN 



2: a single table word (see below) , or LH=0 and 
RH pointing to table. In the latter case, the 
table is terminated with a word. 



SAVE 



RETURNS 



+1: always 



Table Word Format 

LH: length of block to SAVE 

RH: location of first word in block 

Nothing is SAVEd for all zero areas or for non-existent 
pages. It is thus possible to SAVE all assigned non-0 core 
memory with the single table word 777760,, 20. Note that it 
is generally not necessary to SAVE zero core because the 
monitor creates a zero page on the first reference to a 
non-existent page. 

Generates an illegal instruction PSI on error conditions 
below. Can also general several PSI's or fork termination 
on certain file conditions. 

CAUTION: SAVE will not save AC's, JFN is closed and 
released. 



SAVE ERROR MNEMONICS : 



FRKHXl: 
FRKHX2 : 
FRKHX3: 



illegal fork handle 

cannot be used to manipulate a superior fork 

cannot be used to manipulate multiple forks 



All file errors can occur. 
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SSAVE JSYS 203 

Sharable SAVE, for creating shared programs, e.g., 
subsystems . 

ACCEPTS IN 1: LH: fork handle 
RH: JFN 

2: a single table word (see below), or LH=0 and 
RH pointing to table. In latter case table is 
terminated with a word. 

3: flags (none specified yet, 3 should be 0) 

SSAVE 

RETURNS +1: always 

Table Word Format 

LH: negative of number of pages in group 
B18-26: protection to be used for these pages on GET 

B18: set copy on write 

B19: limit access per current access of pages 
B20-22: read, write, xct. 

Examples: 520 for shared page with copy on write 
120 for share page, write protected 

B27-35: first page number in group 

Creates a TENEX sharable SAVE format file on the given JFN, 
copying (not sharing) pages from the given fork. 

The inverse of SSAVE is GET. 

SSAVEing unassigned pages saves nothing for those pages but 
does not produce an error. SSAVE will not save AC's. 

Generates illegal instruction PSI on error conditions below. 
Can also cause several PSI's or fork termination on certain 
file conditions. 

CAUTION: Closes and releases JFN for SAVE files but not for 
SSAVEd files. 

SSAVE ERROR MNEMONICS: 

FRKHXl: illegal fork handle 

FRKHX2: cannot be used to manipulate superior fork 

FRKHX3: cannot be used to manipulate multiple forks 

SSAVXl: file not on DSK: 

SSAVX2: illegal page count in table (>512) 

All file errors can occur. 
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Entry Vector 

An entry vector word can be either: 

LH: length of vector (1-777) 

RH: location of first word of vector 

or (10/50 format) 

LH: JRST (254000) 
RH: ignored by TENEX 

Each fork (process) has an entry vector word stored in its 
PSB. The word is if it has never been set. 



SEVEC JSYS 204 
Sets Entry VECtor 
ACCEPTS IN 1: fork handle 

2: a lecral entry vector or 

SEVEC 
RETURNS +1: always 
Generates illegal instruction PSI on error conditions below 

SEVEC ERROR MNEMONICS: 

FRKHXl: illegal fork handle 

FRKHX2: cannot be used to manipulate superior fork 

FRKHX3: cannot be used to manipulate multiple forks 

SEVEXl: unreasonable length entry vector 
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SCVEC JSYS 301 

Set Compatibility entry VECtor and UUO locations 

ACCEPTS IN 1: a fork handle 

2: XWD entry vector length, entry vector 
location 

3: XWD UUO location, PC location 

SCVEC 



RETURN 



+1: always 



If the location specified in 2 is non-0, the monitor will 
transfer to that location on any monitor UUO (opcode 
040-077) after moving the contents of 40 and the return PC 
to the locations specified by the LII and RII of 3 
respectively. The entry vector length is retained but not 
used by the monitor. If the length and location of the 
entry vector are set to 0, the next monitor UUO will cause 
the compatiblity package (<SURSYS>PAl050 .SAV) to be merged 
and the locations to be set from the file. At that time, 
the UUO and PC locations are set from the RII of words 3 and 
4 respectively of the PA1050 file entry vector. That is, 
the PA1050 entry vector is structured as follows: 

word - entry address for interpreting UUO'S 

word 1 - initial entry for setup and first UUO 

word 2 - entry for GET SHR file routine 

word 3 - location to receive C(40) on UUO 

word 4 - location to receive return PC on UUO 

word 5 - entry for MAKE SHR file routine. 

words 6 and 7 - communication for handling +C, START 
sequences, by cooperation between PA1050 and EXEC. 



All fork handle errors may occur. 
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GEVEC JSYS 205 
Gets Entry VECtor 
ACCEPTS IN 1: fork handle 

GEVEC 
RETURNS +1: with specified fork's entry vector word in 2 
Generates illegal instruction PSI on error conditions below, 

GEVEC ERROR MNEMONICS: 

PRKHX1: illegal fork handle 

FRKHX2: cannot be used to manipulate superior fork 

FRKHX3: cannot be used to manipulate multiple forks 



GCVEC JSYS 300 

Get Compatibility entry VECtor and UUO locations. 

ACCEPTS IN 1: a fork handle 

GCVEC 

RETURNS +1: always, with 

2: LH: entry vector length 
RH: entry vector location 

3: LH: UUO location 
RH: PC location 

All fork handle errors may occur. 
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INPUT/OUTPUT CONVERSION JSYS • S 



INTRODUCTION 

This section of the manual defines those JSYS's which 
do input/output conversion. JSYS^ are available to convert 
in both directions between ASCII text (in core or on a file) 
and integer numbers, floating point numbers, and TENEX 
internal dates and times. 
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NOUT JSYS 224 

Number output (integer) 

ACCEPTS IN 1 : a TENEX destination designator 

2 : a number 

3 : left half: 

B0 : print magnitude if set 

Bl: print plus sign on positive number (or 

magnitude) if set 

B2: leading filler if set, trailing filler if 

clear 

B3: leading 0's if set, leading blanks if 

clear 

B4: do output per B5 on column overflow (and 

take error return) if set, no output on column 

overflow if clear 

B5: asterisks on column overflow if set, all 

necessary digits on column overflow if clear 

B11-B17: number of columns including sign (if 

means print as many columns as necessary) 

right half: 

radix (2-16) 

NOUT 

RETURNS +1: on error, error # in 3 

+2: successful, updated string pointer in 1 (if 
pertinent) 

NOUT ERROR MNEMONICS: 

NOUTXl: illegal radix 

N0UTX2: column overflow 

DESXl: illegal value for designator 

DESX2: tty not available to this job 

DESX3: no name for this JFN 

DESX5 : not open 
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NIN 



JSYS 225 



Input number (integer) . Leading spaces ignored, sign 
handled correctly, terminates on first non-numeric character 
after numeric characters. 

ACCEPTS IN 1: a TENEX source designator 

3: a radix (2-10) 

NIN 



RETURNS +1 : unsuccessful, error # in 3 

updated string pointer (if pertinent) in 1 



+2: successful, number in 2, 
pointer (if pertinent) in 1 



updated string 



NIN ERROR MNEMONICS: 



IFIXXl: illegal radix 

IFIXX2 : first character not a digit in 

specified radix, not a number 

IFIXX3: overflow (low 36 bits returned in 2) 

DESXl: illegal value for designator 

DESX2: tty not available to this job 

DESX3: no name for this JFN 

DESX5: not open 
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Floating Point Conversion JSYS's 



JSYS's for Floating Point I/O Conversion are available 
for both single precision and double precision numbers. The 
double precision binary representation is a superset of the 
DEC double precision representation to permit a wider 
exponent range. The normal DEC double precision format 
permits numbers with an exponent range of approximately 
10 ++38 to 10 +-32. The extended format permits exponent 
ranges of approximately 10++/-9860. However, internal 
limitations in double precision floating input make it 
useful only for the range 10++/-99. While double precision 
floating output will work for the full range, it gets 
increasingly slower and less accurate beyond 10++/-99. The 
accuracy of the double precision routines is generally 14 
decimal digits. The single precision output conversion 
routine is accurate to +/-1 in the eighth digit and exact to 
seven digits. The single precision input conversion routine 
is accurate to eight digits. 

Extended Range Format 

Numbers in the exponent range 10 ++38 to 10 +-32 are 
represented in standard EEC double precision format. 
Numbers in extended range are flagged by the sign bit of the 
second word being set. (This bit is normally cleared in the 
standard DEC double precision format and is both unaffected 
by and ignored in all standard DEC double precision 
arithmetic operations.) With extended range exponents, the 
sign and high order bits of the exponent are stored in bits 
1-8 of the second word. Bit 1 is the sign bit, off for 
positive and on for negative exponents. For positive double 
precision numbers, the full exponent may be obtained by 
concatenating bits 1-8 of the second word with bits 1-8 of 
the first word and then subtracting 200(8). (The 
representation in extended format is still excess 200(8).) 
For negative double precision numbers, the low order 
exponent bits in 1-8 of the first word are negated but the 
high order exponent bits in the second word are to be 
interpreted literally. This permits the PDP-10 instruction 
DFN (double floating negate) to do exactly the right thing 
in negating an extended format number. 
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FLIN JSYS 232 
Floating Point Number Input 

Ignores leading spaces, terminates on first character which 
can't be part of a floating point number. 

ACCEPTS IN 1: TENEX source designator 

FLIN 

RETURNS +1: unsuccessful , error # in 3, updated string 
pointer in 1 (if pertinent) 

+2: successful, single precision floating point 
number in 2 r updated string pointer in 1 (if 
pertinent) 

FLIN ERROR MNEMONICS : 

DESXl: illegal value for designator 

DESX2: tty not available to this job 

DESX3: no name for this JFN 

DESX5: not open 

FLINXl: first character not formatting, 

digit, sign, or "." 
FLINX2: number too small, floating underflow, 

returns 
FLINX3: number too big, floating overflow, 

returns largest number, correct sign 
FLINX4: "." only input or "-.Q", ill- formed number 
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DFIN JSYS 234 

Floating Point Number Input, Double Precision 

ACCEPTS IN 1: TENEX source designator 

DFIN 

RETURNS +1: unsuccessful, error # in 4, updated string 
pointer in 1 (if pertinent) 

+2: successful, double precision floating point 
number (extended format where necessary) in 2 
and 3, updated string point in 1 (if 
pertinent) 

DFIN ERROR MNEMONICS: 

DESXl: illegal value for designator 

DESX2: tty not available to this job 

DESX3: no name for this JFN 

DESX5: not open 

FLINXl: First character not formatting, 

digit, sign, or ". M 
FLINX2: number too small, floating underflow, 

returns 
FLINX3: number too big, floating overflow, 

returns largest number, correct sign 
FLINX4: " . " only input or "-.Q", informed number 



I/O CONVERSION, Section 8, l-September-1973 Page 7 

FLOUT JSYS 233 

Floating Point Number Output 

ACCEPTS IN 1: TENEX destination designator 

2: normalized, single precision floating point 
number 

3: format control word (see below) 

FLOUT 

RETURNS +1: unsuccesful, error # in 3, updated string 
pointer in 1 (if pertinent) . 

+2: successful, updated string pointer in 1 (if 
pertinent) . 

FLOUT ERROR MNEMONICS: 

DESXl: illegal value for designator 

DESX2: tty not available to this job 

DESX3: no name for this JFN 

DESX4: not open 

FLOTXl: column overflow field 1 or 2 

FL0TX2: column overflow field 3 

FL0TX3: illegal format specif, e.g., exponent requested 
but field 3 zero. 
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DFOUT JSYS 235 

Floating Point Number Output, Double Precision 

ACCEPTS IN 1: TENEX destination designator 

2: a normalized double precision 

3: floating point number in either extended or 
non-extended range. 

4: format control word (see below) 

DFOUT 

RETURNS +1: unsuccessful, error # in 4, updated string 
pointer in 1 (if pertinent) . 

+2: successful, updated string pointer in 1 (if 
pertinent) • 

DFOUT ERROR MNEMONICS: 

DESXl: illegal value for designator 

DESX2: tty not available to this job 

DESX3: no name for this JFN 

DESX5: not open 

FLOTXl: column overflow field 1 or 2 

FL0TX2: column overflow field 3 

FL0TX3: illegal format spec, e.g. exponent requested 
but field 3 zero. 
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Floating Output Format Control Word 
Free Format 



The most common format control used with FLOUT and 
DFOUT is free format. This is specified by setting bits 
18-23 of the format control word to 0. In the standard 
case, the entire format control word is set to 0; however, 
most of the other fields may be specified to force a 
particular setting. The effect of this is that all numbers 
of magnitude <10+6 but >=10+-4 are printed in a typical 
Fortran F format (with some exceptions) • If the number is 
an exact integer, the number is printed with no terminating 
decimal point unless point (B6) is specifically requested. 
If the number is a fraction in the range above it is printed 
as .xxxx with no preceding the "." . Non-significant 
trailing zeros in the fraction are never printed. A maximum 
of 7 digits total will be printed if field 2 is not 
specified. The sign of the number is printed only if 
negative. The number zero is printed as "0". 

If the number is beyond the range indicated above, the 
number is printed in a typical Fortran E format (with some 
exceptions) • The exponent is printed as Esxx where xx are 
the digits of the exponent and s is the sign which is 
printed only for negative exponents . The same exceptions 
about when to print the "." and suppression of trailing, 
non-significant zeros as above apply. 

Another form of free format similar to that above is 
invoked by having a non-zero field B13-B17 of the format 
control word. The number in this field specifies 
essentially at what place rounding should occur. If this 
number is 7, the behavior is exactly the same as if it were 
as above. If this number is <7, rounding will occur at 
the specified place but the printout format will be as above 
with a maximum of 7 digits printed. (e.g. 12360 with a 
rounding specification of 3 will print as 12400) . If this 
number is >7, rounding will again occur at the specified 
position but more than 7 digits maximum will be printed. In 
fact, digits will be printed until either the rounding 
specification number is reached or trailing non-significant 
zeros are reached. 
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General Format Control 

This section describes the various , controls available 
for floating point output format when free format is not 
desired. 

B18-B23 The number of characters in field 1 

(normally before the decimal point, 

see field 1 justification control below). 
B24-B29 The number of digits after the decimal point, 

which is field 2 
B30-B35 The number of characters in the exponent 

field, which is field 3 
B13-B17 Specifies digit position for rounding, 

0=>12, 37=>no limit 

B0-B1 field 1 sign control, first character position is 
always used for "-" on negative numbers, 
on positive numbers ; 

W - first character position is digit position 
10 - first character position is "+" 
01 or 11 - first character position is space 

B2-B3 field 1 justification control 

00 - fill field to left with spaces 

01 - fill field to left with 0's 

10 - fill field to left with *'s 

11 - left justify whole number up to M ." by 

filling after field 3 with spaces, 
i.e. field 1 wraps around to after field 3 
B4 If set print at least one digit (0 if necessary) 

in field 1 
B5 Prefix the number with dollar sign ($) 
B6 If print no decimal point, 

If 1 print decimal point 
B7-B8 exponent field control 

00 - no exponent field 

01 - print "E" as first character of exp field 

10 - print M D" as first character of exp field 

11 - print "*10+" as first chars of exp field 
B9-B10 exponent sign control 

first character position of exp field is 

always used for "-" on negative exponents. 

on position exponents ; 

F0" or 11 - "first character position after prefix 
is digit position 

01 - first character position after prefix is M +" 

10 - first char position after prefix is space 
Bll If do no additional output on column overflow; 

If 1 go to free format on overflow of field 1, 
expanded exponent format on field 3 overflow 
Bl2 (not currently used) 
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Date and Time Conversion JSYSs 



As described in the introduction to this manual, 
internal date and time are at the Greenwich meridian. The 
date is days since November 17,1858; the time is seconds 
since midnight, with midnight=0. The date changes at the 
transition from 11:59:59 PM to 12:00:00 midnight. Each is 
an 18-bit quantity, with the date in the LH and the time in 
the RH of a JSYS argument word. 

When converting between local and internal date and 
time, the time zone in which the installation is located is 
normally used, with daylight saving applied from 4AM on the 
last Sunday in April to 3:59:59AM on the last Sunday in 
October, 

The first two JSYS's in this group, IDTIM and ODTIM, 
convert date and time between text strings (in core or on a 
file) and internal format. These should satisfy most, if 
not all, users. However, there are four more JSYS's which 
are subsets of IDTIM and ODTIM. These make available, 
separately, the conversion between internal format date and 
time and separate numbers for local year, month, and day, 
and the conversion between those numbers and text strings. 
They also provide additional options which give the caller 
more control over the conversion performed than IDTIM and 
ODTIM. 

Although the typical user can ignore them, time zones 
occur in the calling sequences of the latter four JSYS's. 
The internal representation of a time zone is as a number 
between -12 and 12 decimal, representing a number of hours 
west of Greenwich. For example, EST is zone 5. Zones -12 
and 12 represent the same time difference but on opposite 
sides of the international date line. 
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ODTIM JSYS 220 

Output date and time. Converts internal date and/or time to 
text. 

ACCEPTS IN 1: TENEX destination designator 

2: internal date and time, 

or -1 to use current date and time 

3: format flags, described below 

ODTIM 

RETURNS +1: always, with updated string pointc»r in 1 if 
pertinent 

Generates illegal instruction PSI on error conditions below. 

ODTIM ERROR MNEMONICS: 

DATEX6: system has no date and time (and -1 was given) 
TIMEXl; illegal time (greater than 24 hours) 

All I/O errors are also possible and produce PSI's or fork 
termination as described for BOUT in section 2. 
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ODTIM format option flags (AC 3) : 

B0 on, omit date from output and ignore B1-B8 

Bl on, output day of week 

B2 on, use full text for weekday 

off, use 3-letter abbreviation 
B3 on, output month as number and ignore B4 
B4 on, use full text for month 

off, use 3-letter abbreviation for month 
B5 on, output 4-digit year 

off, output 2-digit year if between 19 00 and 1999 
B6 on, output day of month after month 

off, output day of month before month 
B7 and B8: date punctuation control: 
both off, use dashes, as 13-APR-70 
B7 on, use spaces, as 13 APR 70 

a comma is also used if B6 is on, as APRIL 13, 1970 
B8 on, use slashes, as 5/13/70 
B9 on, omit time from output and ignore B10-B13 
B10 on, omit seconds 

off, include seconds, preceded by a colon 
Bll on, use 12-hour time and AM-PM 

off, use 24-hour time 
Bl2 on, no colon between hours and minutes 

B13 on, and "-" and time zone to time, e.g. "-EDT" or "-PST" 
Bl7 off, columnate: use leading spaces and zeros so output 
is constant width regardless of the particular date 
or time, for use in printing tables, etc. (Note: 
full month and weekday texts are not coluranated) 
on, suppress columnation: omit leading spaces and zeros, 
producing output appropriate for inclusion in an 
isolated message 

Zero in 3 produces a columnated printout of the form 
" 3-APR-70 1:06:03", for example. 

For convenience, -1 in 3 is taken as 336021000000, which 
produces , 
for example: 

"FRIDAY, FEBRUARY 2, 1973 1:06:03" EST. 

More examples : 

contents of 3^ typical text 

202201000000 "FRI 3 APR 70 1:06" 

336321000000 "FRIDAY, APRIL 3, 1970 1:06AM-EST" 

041041000000 "3/4/70 106:03" 

041040000000 " 3/04/70 106:03" 
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IDTIM 



JSYS 221 



Input date and time. Converts text to internal date and 
time 

ACCEPTS IN 1: TENEX source designator 

2: format option flags, described in detail 
below, for normal case 

IDTIM 

RETURNS +1: unsuccessful, error number in 2, 

updated string pointer in 1 if pertinent 

+2: success 

1: updated string pointer if pertinent 
2: internal format date and time 

IDTIM does not permit inputting either the date or the time 
separately, nor does it permit conversions for time zones 
other than the local one (except if the time zone is 
specified in the input string) . See IDTNC and IDCNV, below, 
for these functions. 

IDTIM ERROR MNEMONICS: 



DILFXl: 
TILFXl: 
DATEXl: 
DATEX3: 
DATEX5 : 



illegal date format 

illegal time format 

illegal year (out of range 1858 to 2576) 

day of month too large 

illeaal date (out of range 17 NOV 1858 

to 7 AUG 2576 GMT) 



All I/O errors are also possible and produce PSI's 
termination as described under BIN in section 2. 



or fork 
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IDTIM Input Format. If all of the format option flags are 
off, IDTIM accepts most any reasonable date and time syntax, 
the following are examples of valid dates: 

17-APR-70 
APR- 17- 70 
APR 17 70 
APRIL 17, 1970 
17 APRIL 70 
17/5/1970 
5/17/70 



Times : 



1:12:13 

1234 

16:30 

1630 

1234:56 

1:56AM 

1:56-EST 

1200NOON 

12:00:00AM 

11:59:59AM-EST 

12: 00: 01AM 



(4:30PM) 



(midnight) 
(late morning) 
(early morning) 



"AM" or "PM" may follow a time not greater than 12:59:59, 
"NOON" or "MIDNIGHT" may follow 12:00:00, and any time may 
be followed by a dash and a time zone (EST, EDT, CST, CDT, 
MST, MDT, PST, PDT, GMT (Greenwich), GDT, DAYLIGHT (local 
daylight saving), STD or STANDARD (local standard)). 

All strings (months, time zones, AM- PM- NOON- MIDNIGHT) may be 
represented by any non-ambiguous abbreviation, e.g. 
D=DECEMBER, M=MIDNIGHT. 

Spaces are ignored before or between fields whenever they 
could not terminate the input string; they are thus not 
allowed before colons, AM- PM- NOON- MIDNIGHT, the dash before 
the time zone, or the time zone. A tab is also allowed 
between the date and time. 



The input string may be terminated by 
character. 



any non-alphanumeric 



The format option flags impose various restrictions on the 
above, and determine the interpretation of ambiguous cases. 
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IDTIM Format Option Flags (AC 2) ; 

Bl on, disallow numeric month and ignore B2-B3 
B2 off, consider the first number to be the month 
in a date such as " 1/2/70" 
on, consider the second number to be the month 
B3 off, if an invalid date can be successfully interpreted 
by assuming the day and month to be in the opposite 
order than that specified by B2, do so. 
This applies, for example, to M 31/1/70" with B2 off 
on, give error return for such dates 
B7 and B8 govern inclusion of seconds in time: 
both off, optional 
B7 on, illegal 
B8 on, mandatory 

Note: seconds must always be preceded by a colon 
B9 and B10 govern use of colon between hours and minutes: 
both off, optional 
B9 on, illegal 
B10 on, mandatory 
Bll and Bl2: when B7 thru Bl0 are all off, times containing 
a single colon are ambiguous. These flags 
determine whether the colon is considered to 
separate the hours and the minutes or the 
minutes and the seconds in such cases 
Both off, take as HH:MM if first field 

is small enough, else as HHMM:SS 
Bll on, always take as HHMM:SS 
B12 on, always take as HH:MM (giving error 
return if first field is too big) , 
This differs from B7 on in that 
seconds can be included if preceded 
by a second colon 
Bl4 on, disallow 24-hour time and make AM-PM mandatory 
B15 on, disallow AM-PM- NOON- MIDNIGHT 
Bl6 on, disallow time zone 
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ODTNC 



JSYS 2 30 



Output date and/or time without conversion from internal. A 
subset of ODTIM, permitting printing of dates and times not 
stored in internal format , and giving the caller control 
over the time zone printed 

ACCEPTS IN 1: TENEX destination designator 

2: LII: real year 

RH: month (January=0) 

3: LH: day of month (first day=0) 
RH: day of week (Monday=0) 

if output thereof requested 

4: LH: if time zone printout requested: 
Bl: on for daylight savings 
B12-B17: time zone 
RH: local time (seconds since midnight) 

5: format option flags, same as ODTIM (above). 
Note: the only time zones which can be printed 
(flag B13) are Greenwich and those in 
the USA 

ODTNC 

RETURNS +1: always, with updated string pointer in 1 if 
pertinent. 

Generates illegal instruction PS I on the error conditions 
below. 

ODTNC ERROR MNEMONICS: 



DATEXl: 
DATE X 2 : 
DATEX3: 
DATEX4 : 
ZONEXl: 
ODTNXl: 



illegal year 

month too large 

day of month too large 

day of week too large 

illegal time zone (not between -12 and 12) 

unprintable time zone 

(not in USA or Greenwich) 



All I/O errors can occur and produce PSI's or 
termination as described for BOUT in section 2. 



fork 
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IDTNC 



JSYS 231 



Inputs date and time without conversion to internal. 
Permits input of date or time separately, which is not 
possible with IDTIM because neither can be converted to 
internal without the other 

ACCEPTS IN 1: TENEX source designator 

2: format option flags: 

those described under IDTIM apply, and also: 
B0 on, do not input date, ignore B1-R3 
B6 on, do not input time, ignore B8-B16 

IDTNC 



RETURNS +1: unsuccessful, error code in 2, updated 
pointer in 1 (if pertinent) . 



string 



+2: success, updated string pointer in 1 (if 
pertinent) • 
if date input not suppressed: 



2: 



3: 



LH 
RH 
LH 
RH 



real year 

month (January=0) 

day of month (first day=0) 

day of week (Monday=0) 



If time input was not suppressed: 

4: RH: time as seconds since midnight 
B0 : off unless a time zone was input 
Bl: on if a daylight saving time zone 

(e.g. EDT) was input 
B2: off unless a time zone was input 
(redundant bits B0 and B2 are for 
compatability with ODCNV) 
B12-B17: time zone, if one was input, 
else local time zone 



IDTNC ERROR MNEMONICS: 



DILFXl: 
TILFXl: 



illegal date format 
illegal time format 



IDTNC does not detect certain errors in date input, such as 
day 31 of a 30-day month. These errors are detected in 
IDCNV. 

IDTNC can cause all I/O errors, which cause PSI's or fork 
termination as described in section 2 for BIN. 
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ODCNV 



JSYS 222 



Output date and time conversion. Breaks internal date and 
time into separate numbers for local weekday, day, month, 
year, and time. Does not convert to text. Gives caller the 
option of explicitly specifying the time zone and whether or 
not to apply daylight saving 

ACCEPTS IN 2: internal date and time, 

or -1 to use current date and time 

4: (0 for normal case) 

B0: off, use daylight savings or not 

as appropriate for given date 
on, see Bl 
Bl: on to use daylight savings if B0 is on 
B2: off, use local time zone 

on, see B12-B17 
B12-B17: time zone to use if B2 on 

ODCNV 



RETURNS 



+ 1: 



always 


2: 


LH: 




RK: 


3: 


LH: 




RII: 


4: 


B0 



real year 

month (0= January) 

day of month (0=first day) 

day of week (0=Monday) 
and B2: ON for compatibility with IDCNV 
Bl: on if daylight savings was applied 
B12-B17: time zone used 
RH: local time in seconds since midnight 



Generates illegal instruction PSI on the error conditions 
listed below. 

ODCNV ERROR MNEMONICS: 



DATEX6 : 
TIMEXl: 
ZONEXl: 



system has no date and time (and -1 was given) 
illegal time (greater than 24 hours) 
illegal time zone (not between -12 and 12) 
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IDCNV 



JSYS 22 3 



Input date and time conversion. Translates separate numbers 
for local year, month, day, and time into internal format 
(Greenwich) date and time 

ACCEPTS IN 2: LH: real year 

RH: month (January*=0) 
3: LH: day of month (first day=0) 
4: LH (0 for normal case): 

B0 : off, use daylight saving if appropriate 

on, see Bl 
Bl: on to use daylight saving if on 
B2: off, use local time zone 

on, use time zone in B12-B17 
B12-B17: time zone if B2 on 
RH: local time in seconds since midnight 

IDCNV 



RETURNS 



+1: unsuccessful, error number in 1 



+2: success 

2 : internal date and time 

4: B0 and B2: ON for compatibility with ODCNV 

Bl: on if daylight savings was applied 

B12-B17: time zone used 



IDCNV ERROR MNEMONICS: 



DATEXl: 
DATEX2 : 
DATEX3: 
DATEX5: 

TIMEXl: 
ZONEXl: 



illegal year (out of range 1858 to 2576) 

month too large 

day of month too large 

illegal date 

(out of range 17-NOV-1858 to 7-AUG-2576 GMT) 

illegal time (greater than 24 hours) 

illegal time zone 
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PRIVILEGED JSYS'S 



INTRODUCTION 



This section of the JSYS manual discusses privileged 
JSYS's which ordinary users need not know about and cannot 
execute. This is labeled Section 10 , intentionally 
reserving Section 9 for "MISCELLANEOUS". 
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CRDIR 



JSYS 240 



Creates or modifies a directory entry. 
ACCEPTS IN 1: string pointer to directory name 



LH: 
B0 

Bl 
B2 

B3 
B4 
B5 

B6 

B7 

B8 

B9 

Bl0 
Bll 
B12 

B13 
B14 
B15 
B16 

RH: 



set directory name from parameter block 

NOT IMPLEMENTED YET 
set password from parameter block 
set maximum disc file storage from 

parameter block 
set privilege bits from parameter block 
set mode bits from parameter block 
set special resource information from 

parameter block 
set directory number from parameter block 
(only legal for new directories) 
set default file protection from parameter 

block 
set directory protection from parameter 

block 
set default backup spec from parameter 

block 
set last log in 

set user group word from parameter block 
set directory group word from parameter 

block 
not used 
not used 
not used 
delete this directory entry 



pointer to parameter block (E) 

3: device designator 

CRDIR 

RETURNS +1: always, with directory number in 1 

Requires WHEEL or OPERATOR status enabled. 
(This restriction may be removed in part to 
enable a user to change his own password, 
decrease maximum disc file storage, etc.) 
Generates illegal instruction trap on error 
conditions. 
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CRDIR ERROR MNEMONICS: 



CRDIXl: 

CRDIX2: 

CRDIX3: 
CRDIX4: 
CRDIX5: 
CRDIX6: 



WHEEL or OPERATOR special 

capability not enabled 

name pointed to by 1 is old and 

directory number disagrees with it 

no room in JSB 

no room in sub index 

null name not allowed 

name pointed to by 1 is new but 

directory number is already used 
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Parameter Block 

E string pointer to directory name 

E+l string pointer to password 

E+2 max # pages which can be used for perm disc storage 

E+3 B18 user is WHEEL, Bl9 user has OPERATOR privileges 

B20 user can see system confidential information 

(e.g. error printouts) 
E+4 B0 off directory name useable for logging in or CNDIR 
on directory name can only be used for CNDIR 

Bl off accounts must be numeric 

on accounts may be alphanumeric 

B2 (used only by EXEC) 

off, print each login message only once 
on, repeat login message at each login 
E+5 special resource info not currently used 
E+6 directory number, if user specifies a non-unique number 

this will generate an error. 
E+7 default file protection (18 bits right justified) 
E+10 directory protection (18 bits right justified) 
E+ll default file retention specification. Currently only 

the right 4 bit field is used to specify the default 

number of versions of a file to retain on the disc. 
E+12 data to set last log in to 
E+l 3 user group word 
E+14 directory group word 

If CRDIR is for a new directory name, the new directory name 
is pointed to by 1. If B0 of E+4 is off, a password must be 
supplied (Bl of 2 ignored) . Other bits of 2 may be on or 
off optionally. In particular, if the following bits are 
off, CRDIR will default fields to: 

B2 off sets maximum disc file storage to 512 pages 

B3 off implies no special privileges 

B4 off implies directory name which can be used 

for logging in but requires numeric account 
B5 off implies no special resource information 
B6 off finds the next highest (but unused) directory 

number and assigns it to this directory name. 

B6 should normally be off . 
B7 off sets default file protection to 777752 
B8 off sets directory protection to 777740 
B9 off sets default file retention word to 2 
B10 off sets last login to 18 November 1858 
Bll off sets user group word to 
B12 off sets directory group word to 

If CRDIR is for an old directory name and if any of B0-B17 
are off, the particular parameters are simply not affected. 
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GTDIR JSYS 241 

Gets directory entry information, 

ACCEPTS IN 1: directory number 

2: pointer to where remaining "parameters" should 
be stored (E) 

3: string pointer for where to store password 

GTDIR 

RETURNS +1: always, updated string pointer in 3 

Requires WHEEL or OPERATOR status enabled. 
Generates illegal instruction PSI on error 
conditions below. 

The parameter block at E is compatible with 
CRDIR. E+0 is not touched by the JSYS. E+l 
points to the beginning of the password string 
(i.e., the argument supplied in 2) . From E+2 
to E+14, items are the same as CRDIR. E+12 
receives the date and time of last LOGIN. 

GTDIR ERROR MNEMONICS: 

GTDIXl: neither WHEEL nor OPERATOR special 

capability enabled 
GTDIX2: no such directory 
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DSKOP JSYS 242 

Disk operate. Allows hardware-oriented specification of 
clisT "~ transfers. Requires WHEEL or OPERATOR special 
capability. 

ACCEPTS IN 1: If B0 off, right justified 
hardware disk address 
If B0 on, right justified 
linear (software) address. 

2: B13: write header 
Bl4: write 
Bl5: compare class 
B16-B24: class 
B25-B35: word count (max 1000 octal) 

3: virtual core address 

DSKOP 

RETURNS +1: always 

1: B24-B35: error bits from 6 3 
if no errors 

Transfer must not cross page boundary. 

If transfer produces any kind of error, 5 repeats will be 
attempted, and the error bits from the last attempt returned 
in 1. 

Generates illegal instruction PSI on error conditions below. 
DSKOP ERROR MNEMONICS: 

WHELXls WHEEL or OPERATOR special capability 
not enabled 
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SPRIW • JSYS 243 

Set PRI ority word. JSYS under development. Requires 
enabled WHEEL capability. 



DSKAS JSYS 244 

DiSK Assignment control, attempts assignment of specific 
cTisTc acTdress. 

ACCEPTS IN 1: disk address 

DSKAS 

RETURNS +1: unsuccessful, address already assigned 

+2: address available and assigned 

DSKAS may also be used to deassign an assigned disk address 
by setting B0 of the disk address word in 1. If the address 
was assigned, return is to caller plus 1. If the address 
was not previously assigned, a BUGCHK will occur in the 
monitor. 

DSKAS may also be used to request assignment of a free disk 
page near the disk address given in 1 by also having Bl of 1 
set in the call. Assignment will be on the same track as 
specified by the disk address if possible or else on a 
nearby track. If the disk address given is 0, a page will 
be assigned on a track which is at least 1/2 free. In this 
last case of DSKAS, a return to caller plus 1 means the 
assignment was impossible because the disc was full. The 
return to caller plus 2 returns the assigned disk address in 
1. 

Generates illegal instruction PSI on error conditions below. 

DSKAS ERROR MNEMONICS: 

WHELXl: WHEEL or OPERATOR special capability not enabled 
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SJPRI 



JSYS 245 



Set Job Priority. Sets the scheduler priority control word 
for any job. Requires WHEEL or OPERATOR capability. 

ACCEPTS IN 1: Job number 

2: Priority word 

SJPRI 

RETURNS +1: illegal or non-existent job number 
+1: successful completion 

The priority word is set in the top fork of the designated 
job, but not in any existing inferior forks. The priority 
word is always passed down when a fork is created. A 
priority word of means no special action. A job may be 
guaranteed a certain percentage of CPU resources (CPU 
time/real time) by placing the desired percentage (1-99) in 
the left half of the priority word. 



The right half is used for some installation 
experimental purposes and should always be 0. 



dependent or 



SJPRI ERROR MNEMONICS: 

WHELXl: WHEEL or OPERATOR capability not enabled. 



PRIVILEGED JSYS's Section 10 l-September-73 Page 



MSFRK JSYS 312 

MSFRK (Monitor Start FoRK) is exactly like SFORK (see 
Section 6) except that it uses the entire contents of AC2, 
including the User Mode and other flags, for starting the 
fork. Thus a fork can be started in monitor mode. This 
JSYS is legal only if: 

a) It is called from monitor mode, or 

b) Wheel or Operator capability is enabled. 

MSFRK was implemented to allow job zero to spawn multiple 
forks to handle various asynchronous monitor tasks. 

Note: The starting context is undefined, so the fork being 
started should execute the following sequence at its 
starting address: 

FBGN: MOVSI A,UMODF ;A FAKE USER MODE PC 
MOVEM A,FPC ; SIMULATE A JSYS CALL 
JSYS MENTR ; ESTABLISH USUAL CONTEXT 

This causes a stack and AC block to be set up, etc. 



HSYS JSYS 307 

Accepts in 1: Date and time in standard GTAD format, for 
scheduled shutdown, or to abort a shutdown 
in progress. 

2: Date and time service will resume, for 
information only 

This JSYS declares a specific time at which the system will 
be forcefully shut down, and then proceeds to do so. 
Therefore, it requires WHEEL, OPERATOR, or MAINTENANCE 
capability. Notification will be broadcast to all users 
periodically before the shutdown. When the shutdown time 
arrives, any remaining users will be logged off, except 
those on the CTY and OTY (see below under startup 
procedure) . The message "SHUTDOWN COMPLETE" will be typed 
on the CTY, and unless a job is still on one of the two 
privileged terminals, the machine will halt. 

The current shutdown and restart times are available using 
the GETAB's on the SYSTAT system table (see Section 3). 
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USRIO JSYS 310 

Enables execution of I/O instructions in user mode for 
maintenance programs. Requires MAINTENANCE, WHEEL, or 
OPERATOR capability. 

RETURNS +2: failure, error code in 1 
+ 2: success 

USRIO ERROR MNEMONICS: 

CAPXl: WHEEL or OPERATOR capability not enabled 



PEEK JSYS 311 

Transfers a block of words from monitor to user space. 

ACCEPTS IN 1: XWD word count, 

first monitor address 

2: first user address 

PEEK 

RETURNS +1: failed, error number in 1 

+2: success, n words transferred. 

Block must not cross monitor space page boundary, and 
MAINTENANCE, WHEEL, or OPERATOR capability is required. 

PEEK ERROR MNEMONICS: 

CAPXl: (special capability required) 

PEEKXl: transfer cannot cross monitor page boundary 

PEEKX2: monitor page read-protected 
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JSYS Jump to System 



+ + + — + + + 

| 104 | A |l | X | Y | 

+ + + — + + + 

8 9 12 13 14 17 18 35 

If the effective address is 1000 [8] or greater, fetch a 
double (left half, right half) pointer from the effective 
address. Store the flags and incremented PC in the location 
indicated by the left half pointer and jump to the location 
indicated by the right half pointer. The flags and PC are 
stored in the left and right halves respectively of the 
indicated word. 

If the effective address is less than 1000 [8], the 
instruction is an EX JSYS (exec JSYS) . Enter monitor mode 
(leave user mode) and fetch a double pointer from the real 
core address (unmapped) equal to 1000+ the effective 
address. As above, the flags and PC are stored through the 
left half pointer and control, jumps (in monitor mode) to the 
location indicated by the right half pointer. 

This instruction provides a very fast way for a user program 
to call on Monitor-provided services such as word or 
character I/O, or number conversion. Arguments are 
typically passed and returned in the AC's, and the Monitor 
returns control with a JRST 2,@ through the location where 
the PC and flags were stored. 

This instruction may also be used in user mode (with an 
effective address greater than 10 00) to dispatch through a 
transfer vector into routines which must be kept reentrant. 
(The pointers for storing PC and flags would point into a 
temporary storage region in this case.) 
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LGINX1 
LGIHX2 
LGINX3 
LGINX4 
LGINX5 
CRJBX1 
CRJBX2 
CRJBX3 
CRJBX4 
CRJBX5 
CRJBX6 
CRJBX7 
L0UTX1 
L0UTX2 
CACTX1 
CACTX2 
EFCTX1 
EFCTX2 
EFCTX3 

Contac 
GJFX1 
GJFX2 
GJFX3 
GJFXU 
GJFX5 
GJFX6 
GJFX7 
GJFX8 
GJFX9 
GJFX10 
GJFX11 
GJFX12 
GJFX13 
GJFX14 
GJFX15 
GJFX16 
GJFX17 
GJFX18 
GJFX19 
GJFX20 
GJFX21 
GJFX22 
GJFX23 
GJFX24 
GJFX25 
GJFX26 
GJFX27 
GJFX28 
GJFX29 
GJFX30 



600010 
600011 
600012 
600013 
600014 
600020 
600021 
600022 
600023 
600024 
600025 
600026 
600035 
600036 
600045 
600046 
600050 
600051 
600052 
t operat 
600055 
600056 
600057 
600060 
600061 
600062 
600063 
600064 
600065 
600066 
600067 
600070 
600071 
600072 
600073 
600074 
600075 
600076 
600077 
600100 
600101 
600102 
600103 
600104 
600105 
600106 
600107 
600110 
600111 
600112 



LOGIN 
LOGIN 
LOGIN 
LOGIN 
LOGIN 
CRJOB 
CRJOB 
CRJOB 
CRJOB 
CRJOB 
CRJOB 
CRJOB 
lUeg 
LGOUT 
CACCT 
CACCT 
EFACT 

efact 

EFaCT 

or or j 

GTJFN 
GTJFN 
GTJFN 
GTJFN 
GTJFN 
GTJFN 
GTJFN 
GTJFN 
GTJFN 
GTJFN 
GTJFN 
GTJFN 
GTJFN 
GTJFN 
GTJFN 
GTJFN 
GTJFN 
GTJFN 
GTJFN 
GTJFN 

GTJFN 
GTJFN 
GTJFN 
GTJFN 
GTJFN 
GTJFN 
GTJFN 
GTJFN 
GTJFN 
GTJFN 



that directory number 



file 

fill 



Illeg account 
Can»t Log in under 
NO ROOM In 3ystem 
Password incorrect 
Already Logged in 
Cannot open Pri In 
Cannot open Pri out 
Uleg account 
Terminal not available 
Illeg directory # 
NO ROOM in system 
Password Incorrect 
1 attempt to LGOUT job 
No such job 
Illegal account 
Not Jogged in 
LOG Spec Cap not enabled 
Entry longer than 64 words 
Accounting system failure, 
ystems Personell 
Desired "JFN M illeg 
Desired JFN not available 
No JFN»s available 
Illeg char 

More than 39 chars in a field 
Two device fiilds or device not first 
Two directory fields or directory after 
"<*not following M * M 
More than 1 name field 
Non-numeric version 
Two version fields 
Two accounts 
Two protections 
Bad protection 
Illeg confirmation char 
No such devlc* 

directory 

file name 

extension 

version 

file (it disappeared) 



name 



No 
No 
No 
No 

No 
J5B 



such 
such 
such 
such 
such 
full 



Directory full 

Old file required 

Name given for non-directory device 

Extension for non-directory device 

New file required 

Device not mounted 

Device not available 

Numeric account required 
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GJFX31 

GJPX32 

GJFX33 

0PNX1 

0PNX2 

0PNX3 

opNxa 

0PNX5 

0PNX6 

0PNX7 

0PNX8 

0PNX9 

OPNX10 

0PNX1 1 

0PNX12 

0PNX13 

0PNX1U 

0PNX15 

0PNX16 

0PNX17 

0PNX18 

0PNX19 

OPNX20 

0PNX21 

0PMX22 

DESX1 

DBSX2 

DBSX3 

DESX4 

DESX5 

DESX6 

DESX7 

DESX8 

CLSX1 

CLSX2 

RJFNX1 

RJFNX2 

RJFNX3 

DELFX1 

SFPTX1 

SFPTX2 

SFPTX3 

CNDIX1 

CNDIX2 

CNDIX3 

CNDIXl* 

CMDIX5 

SFBSX1 

SFBSX2 

10X1 



600113 
60011U 
6001 15 
600120 
600121 
600122 
600123 
60012U 
600125 
600126 
600127 
600130 
600131 
600132 
600133 
60013U 
600135 
600136 
600137 
600140 
6001U1 
600142 
600143 
600144 
600145 
600150 
600151 
600152 
600153 
600154 
600155 
600156 
600157 
600160 
600161 
600165 
600166 
600167 
600170 
600175 
600176 
600177 
600200 
600201 
600202 
600203 
600204 
600210 
600211 
600215 



OTJFN 

GTJFN 

GTJFN 

OPENF 

OPENF 

OPENF 

OPENF 

OPENF 

OPENF 

OPENF 

OPENF 

OPENF 

OPENF 

OPENF 

OPENF 

OPENF 

OPENF 

OPENF 

OPENF 

OPENF 

OPENF 

OPENF 

OPENF 

OPENF 

OPENF 

1X169 

That 

unass 

lUig 

riu 

File 

JFn M 

FILE 

CiOSF 

CLOSF 

RLJFN 

RlJFN 

RLJFN 

DUFJ 

SFpTR 

SFPTR 

SFpTR 

CNDIR 

CNDIR 

CNDIR 

CNDIR 

CNDIR 

SFBSZ 

OPENF 

R«adi 



IUeg H *" 
Empty directory 
NULL NAME NOT AL 
or RNAMF* file op 
File doesn't «xi 
Read access not 
Writ® access not 
Execute access n 
Append access no 
Device assignid 
Device not mount 
Fii« busy 
NO ROOM 

WHEEL 0? OPER Sp 
List access not 
Illeg access 
Illeg mode 
Nbn read/writ* a 
File has bad ind 
NO ROOM FOR LONG 
NO ROOM TO INITI 
IMP IS NOT UP 
HOST IS NOT UP 
CONNECTION RBFUS 
CONNECTION BXTB 
TENBX sQUrce/dist 
terminal not avail 
igned «JFN 

use of terminal 
not open 
must be A TTX 
UST NOT REFER TO 
MUST BE ON DISK 
I File not open 
File not ciosabi 
File i» open 
jfn being uses t 
JFN not accessib 
you don't have de 
I File not open 
illeg to set thi 
illeg pointer (e 
(used for paesvor 
Incorrect passvo 
Invalid director 
Can't check pass 
Not logged in 
Can't change byt 
or SFBSZt Illeg b 
ng from a file not 



and "*" given for name 

LOWED 

en 

st 

allowed 

allowed 
ot allowed 
t allowed 
to another job 
ed 



ec cap needed to not change dates 
allowed 



ccess not allowed 
ex block 

FILE PAGE TABLE TABLE 
ALISE INDEX BLOCK 



ED 

SUE MISMATCH 

ination designator 

able 

designator or string pointer 



OUTPUT ASTERISKS 



e by this fork 

o accumulate file name 
le to this fork 
lete access to file 

s file's pointer 

g less than ol) 

d eheck only)? incorrect password 

rd 

y # 

word when logged in 

e size for this opening of file 
yte size 
open for reading 
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10x2 600216 writing on a file not open for writing 

10X3 600217 rIn or ROUT? Can't change point©? for this opening of fi 

**Xe 

10X4 $00220 Reading beyond end of file 

10X5 600221 Data error 

PMAPX1 6002U0 PMAPi Illeg access nquest 

PMAPX2 600241 PttAP! Illeg case 

SPACX1 600245 sPACSj Illeg access request 

FRKHX1 600250 Illeg forfc handle 

FRKHX2 600251 Attempt to manipulati a superior for* 

FRKHX3 600252 Illeg attempt to manipulate multiple forks 

prkhxu 600253 Fork running 

frkhxS 600254 hForki Fork(s) already halted 

FRKHX6 600255 CFORKI Fork handles used UP 

0TABX1 600267 gEtabi Illeg table index 

GTABX2 600270 GETABI Illeg table # 

RUNTX1 600273 RUNTMI Fork handle -3 or -4 given 

stadxi 600275 sTadj Date & time already set and not wheei, or oper 

STADX2 600276 STaD! Ridiculous dati or time 

ASNDX1 600300 aSnd: unassignable djvice 

ASNDX2 600301 ASNDi Illeg to assign this device 

ASNDX3 600302 aSnD or CSYNO! No such device 

C5YNX1 600312 cSyno! Synonym already in use 

ATACX1 600320 ATACH1 Illeg job # 

ATACX2 600321 ATACH! Job already attached 

ATACX3 600322 aTaCH! Directory # does not match 

ATACXU 600323 aTacHi Password Incorrect 

AXACX5 600324 aTaCHj No controlling terminal 

DCHRX1 600330 DVCHRl Illeg device designator 

STDVX1 600332 STDEVI No such devici 

DEVX1 600335 Illeg deviee designator 

DEVX2 600336 Device assigned to another job 

DEVX3 600337 Device not mounted 

MNTX1 600345 MOUNT! Bad directory 

MNTX3 600347 MOUNT! Unmountable device 

TERMX1 600350 All or dtIi That cod* not useable for psi's 

ATIX1 600352 ATlt Illeg channel # 

ATIX2 600353 ATI! Spec cap requirid to assign *C 

DTIX1 600355 dTii That code wasn't assigned to you 

TTYX1 600360 sTi! Not a terminal or no such terminal 

CFRKX2 600362 cFoRKt Can't start fork with no pages 

CFRKX3 600363 CFORKf NO ROOM in System 

KFRKX1 600365 KFORM Can't kill top level fork 

KFRKX2 600366 KFoRKJ Can't kill self 

RFRKX1 600367 RFoRKf Attempt to resume non-frozen fork(s) 

GFRKX1 600371 GFRKSt Illeg fork handle in 2 

QETX1 600373 SET! Bad save file format 

GETX2 600374 GET! System's Special Pages Table full 

SFRVX1 600377 SFRKVj Illeg ent vect relative position 

N0UTX1 600407 N0UT! Radix out of range 2 to 10 
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N0UTX2 600410 NOUT! Column overflow 

IFIXX1 600414 kInj Radix out of rang* 2 to 10 

IFIXX2 600413 nIni First character not a digit 

IFIXX3 600U16 NIN8 Overflow 

GFDBX1 600424 GTFDBI Illeg dispiac#ment 

0FDBX2 600425 OTfdbi Illeg number of words 

0FDBX3 600426 OTFDBt You don't hav# list access to file 

cfdbxi 600430 cHfdbi Illeg displaciment 

CFDBX2 600431 cHFDBt Illeg to change those bits 

CFDBX3 600432 CHFDBI XoU don't hav* spec Cap or file access to change 

**those bits 

CFDBX4 600433 CHFDB* Illeg value for those bits 

DUMPX1 600440 dUmfi/oj Command list error 

DUMPX2 600441 DtfMPI/03 JFN wasn»t opened in mode <|7 

DUMPX3 600442 OUMPI/Oi Address too big or crosses end of memory 

DUMPX4 600443 DUMPI/Ol Memory access error 

RNAMX1 600450 rNamfi Files not on same device 

RNAMX2 600451 RNftMF| DESTINATION FXIB DISAPPEARED 

RNAMX3 600452 RNAMFl ACCESS TO DESTINATION NOT AVOWED 

RNAMX4 600453 RNAMFl NO ROOM 

BKJFX1 600454 can't BKJFN that device twice 

TIMSX1 600460 Time greater than 24 hours 

ZONEX1 600461 Time zone but of range »12 to 12 

0DTNX1 600462 ODTIM can't print time zones except USA and Greenwich 

DILFX1 600464 Illegal date format 

TILFX1 600465 illegal time format 

DATEX1 600466 year out of range 1858 to 2576 

DATEX2 600467 Month greater than 11 

DATBX3 600470 Day of mbnth too large 

DATEX4 600471 Dfty of week greater than 6 

DATEX5 600472 Date out of legal range 

DATEX6 600473 system date and time not set 

SM0NX1 600515 SMONJ LOO spec cap not enabled 

CPRTX1 600520 CPRTFi Xbu don't hav# access to file to change protectio 

**n 

sactxi 600530 SACTFI File not on multiple-directory device 

SACTX2 600531 SACTFI JSB full 

SACTX3 600532 sActfj Directory requires numeric account 

SACTX4 600533 sACTFf You don't havi access to file to change account 

GACTX1 600540 SACTFI File not on multiple^directory device 

0ACTX2 600541 QACTFJ File doesn»t *xist 

FFUFX1 600544 FFUFPt File not open 

FFUFX2 600545 ffufpi File not on multipie-direotoiry device 

FFUFX3 600546 FFuFPI No used page found 

DSMX1 600555 dSmntj Can*t dismount «» fiie(s) open 

RDDIX1 600560 RDDIR failure 

SIRX1 600570 slRl table address l#ss than 20 

SSAVX1 600600 sSavei File not on disk 

SSAVX2 600601 SSAVEI Page count griater than 1000 

SEVBX1 600610 SEVECI Entry vector longer than 777 
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WHELX1 60061U WHEEL or OPERATOR special capability not enabled 

CRDIX1 600620 CROIR! WHEEL or OPER spec cap not enabled 

CRDIX2 600621 cRDIRl Wrong directory # for name 

CRDIX3 600622 CRDIRl JSB full 

CRDXXtt 600623 CRDIRl Sub-index full 

CRDIX5 60062U CRDIRl Null name ill*g 

CRDIX6 600625 cRDIRl Can»t change # of old directory 

CRDIX7 600626 CRDIR! CAN'T KILL DIRECTORY WITH BUSY FILES 

GTDXX1 6006U0 GTDIRI WHEEL Op OPER spec cap not enabled 

GTDIX2 6006U1 GTDIRI No such directory # 

FLINX1 600650 FLINJ First char not blanK or numeric 

FLINX2 600651 FLiNt Number too small 

FLINX3 600652 FHHi Number too large 

FLINX4 600653 fLini Bad format 

FLOTX1 600660 FLOUT! Field overflow before or after point 

FLOTX2 600661 FLoUTt Exponent field overflow 

FL0TX3 600662 FLOUTI Illeg format spec 

F0FRX1 600700 FDFRBI Not a multipl* directory device 

FDFRX2 600701 FDFREI No such directory « 

ATPX1 600710 ATPTYI Bad rec»v JFN 

ATPX2 600711 ATPTY! ReC»v JFN not read 

ATPX3 600712 ATPTYJ Rec»v JFN net open 

ATPX4 600713 ATPTYI ReCv JFN not net 

ATPX5 60071U ATPTYI ReC»v JFN net unused 

ATPX6 600715 ATPTYI Rec'v connection refused 

ATPX7 600716 ATPTYI Send JFN Bad 

ATPX8 600717 ATPTYI Send JFN not write 

ATPX9 600720 ATPTYI Send JFN not open 

ATPX10 600721 ATPTYI Send JFN not net 

ATPX11 600722 ATPTYI Send JFN not unused 

ATPX12 600723 ATpTYt Send connection refused 

ATPX13 60072U ATPTYl NO NVT's 

CVSKX1 600730 CVSKTI Bad JFN 

CVSKX2 600731 CVSKTI Local socket illegal in this context 

DPX1 60073U DISPLAY JSYS8 UNASSIONED DISPLAY PROCESS 

DPX2 600735 DISPLAY JSYSS ILLEGAL DISPLAY PROCESS NUMBER 

STRDX1 6007U0 STRDP (STSDP)I ILLEGAL MAP WORD 

STRDX2 6007U1 STRDP (STSDP)5 TOO MANY PAGES LOCKED 

STRDX3 600742 STRDP (STSDP)I N0N-READABLE-WRXTA8LE*EXECUTABLE PAGE 

STTX1 6007UU sTtypi Illegal terminal type number 

RNAMX5 600750 RNaMFI DESTINATION BUSY 

RNAMX6 600751 RNaMFI DESTINATION HAS BAD PAGE TABLE 

RNAMX7 600752 RNaMFI SOURCE DISAPPEARED 

RNAMX8 600753 RNaMFI ACCESS TO SOURCE NOT ALLOWED 

RNAMX9 60075U RNaMFI SOURCE IS EMPTY 

RNMX10 600755 RNAMFl SOURCE BUSY 

RNMX11 600756 RNAMFl SOURCE HAS BAD PAGE TABLE 

RNMX12 6007B7 RNaMFI RENAME TO SELF 

ilinsi 600770 illegal instruction ixecuted 

ILINS2 600771 unassiqrned JSYS executed 

ILINS3 600772 10/50 UUO executed and compatability file not found 
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5 


19 
10 


CFOBF 


101 


4 


19 


Channel usage 


- 


5 


5 


CFORK 


152 


6 


7 


Character Set 


- 


4 


17 


CHFDB 


64 


2 


65 


CHNTAB 


- 


5 


10 


CIS 


141 


5 


22 


Class 


- 


4 


17 


CLOSF 


22 


2 


24,84 


CLS 


- 


2 


83,84 


CLZFF 


34 


2 


25 


CNDIR 


44 


2 


43 


Control Character Output Control 


- 


4 


15,17 


CPRTF 


33 


2 


35 


CRDIR 


240 


10 


2 


CRJOB 


2 


1 


3 


CSYNO 


72 


4 


9 



1-2 



NAME 



JSYS 



SECTION 



PAGE 



CVHST 
CVSKT 



276 
275 



90 
89 



Data mode 

Dataset carrier off 

Date and Time Conversion JSYS's 

Date and time input formats 

Date and time Standards 

DBUGSW 

DEBRK 

Deferred Terminal Interrupts 

DELDF 

DELF 

DELNF 

DEVCHR 

Device dependent Status bits 

Device designator 

DEVNAM 

DEVST 

DEVUNT 

DFIN 

DFOUT 

DIBE 

DIC 

DIR 



— 


4 


13 


- 


5 


8 


- 


8 


11 


- 


8 


15 


- 


INTRO 


7 


- 


3 


12 


136 


5 


4,19 


- 


5 


9 


67 


2 


66 


26 


2 


29 


317 


2 


30 


- 


3 


10 


- 


4 


2,10,11 


- 


INTRO 


5 


- 


3 


10 


121 


4 


44 


- 


3 


10 


234 


8 


6 


235 


8 


8 


212 


4 


22 


133 


5 


16 


130 


5 


14 



1-3 



NAME 



JSYS 



SECTION PAGE 



DIRST 

DISMS 

DOBE 

DRMERR 

DSKERR 

DSKAS 

DSKOP 

DSMNT 

DTACH 

DTI 

DUMP I 

DUMPO 

DVCHR 



41 


2 


40 


167 


6 


21 


104 


4 


22 


- 


3 


10 


- 


3 


10 


244 


10 


7 


242 


10 


6 


123 


4 


46 


115 


4 


31 


140 


5 


20 


65 


2 


67 


66 


2 


68 


117 


4 


43 



Echo mode 

EFACT 

EIR 

Entry vector 

End of File Pointer 

ENTFLG 

EPCAP 

Error numbers 

ERSTR 

ESOUT 

EX JSYS 



- 


4 


13 


5 


1 


7 


126 


5 


12 


- 


7 


1,3,4,7,9 


- 


2 


7 


- 


3 


12 


151 


6 


5 


- 


3 


5 


11 


3 


6 


313 


2 


48 


_ 


APPEND 


1 



1-4 



NAME 



JSYS 



SECTION PAGE 



Extended Range Format 



FACT file 

FDFRE 

FFFFP 

FFORK 

FFUFP 

FH 

File Access Protection 

File descriptor block 

File designator 

File Group Descriptors 

File Handles 

File Names 

File References in TENEX 

FLHST 

FLIN 

Floating Output Format Control Word 

Floating point conversion JSYS's 

FLOUT 

Forced termination 

Fork Handle 

Fork/File Handle 

Fork Status word 

Free Format 



- 


1 


5,6,7 


213 


4 


48 


31 


2 


34 


154 


6 


10 


211 


2 


34 


- 


2 


82 


- 


2 


5 


- 


2 


63 


- 


INTRO 


5 


- 


2 


18 


- 


2 


1 


- 


2 


3 


- 


2 


1 


277 


2 


90 


232 


8 


5 


- 


8 


9 


- 


8 


4 


233 


8 


7 


- 


5 


7 


- 


INTRO 


6 


- 


INTRO 


6 


- 


6 


12 


mm 


8 


9 



1-5 



NAME 



JSYS 



SECTION PAGE 



FS 



82 



GACTF 

GCVEC 

GDSKC 

GDSTS 
GDSTS 

General Format Control 

GET 

GETAB 

GETER 

GETNM 

GEVEC 

GFRKH 

GFRKS 

GJINF 

GNJPN 

GPJFN 

GTABS 

GTAD 

GTDAL 

GTDIR 

GTFDB 

GTJFN 

GTRPI 

GTRPW 



37 


2 


38 


300 


7 


9 


214 


4 


47 


145 
145 


4 
2 


2,10 
86 


- 


8 


10 


200 


7 


3 


10 


3 


14 


12 


3 


7 


177 


3 


8 


205 


7 


9 


164 


6 


18 


166 


6 


19 


13 


3 


1 


17 


2 


21 


206 


2 


71 


105 


4 


23 


227 


3 


4 


305 


3 


8 


241 


10 


5 


63 


2 


64 


20 


2 


15, 81 


172 


3 


8 


171 


5 


23 



1-6 



NAME 



JSYS 



SECTION PAGE 



GTSTS 
GTTYP 



24 
303 



28 
29 



HALTF 

HFORK 

Host-Host 

HOSTN 

HSTNAM 

HSYS 



170 


6 


21 


162 


6 


17 


- 


2 


85,88 


- 


3 


13 


- 


3 


12 


307 


10 


9 



IDCNV 

IDTIM 

IDTNC 

IIC 

IMP 

IMPHRT 

IMPLTl 

IMPLT2 

IMPLT3 

IMPLT4 

Indexable file handle 

INIDR 

Input/output errors 

INR/INS 



223 


8 


20 


221 


8 


ll f 14 


231 


8 


18 


132 


5 


15 


- 


3 


12 


- 


3 


12 


- 


3 


13 


- 


3 


13 


- 


3 


13 


- 


3 


13 


- 


2 


18 


124 


4 


46 


- 


2 


8 


mm 


2 


88 



1-7 



NAME 



JSYS 



SECTION PAGE 



Internal date and time 
Interpretation of TRAP Word 



11 
24 



JFN Mode Word 

JFN status word 

JFNS 

JOBDIR 

JOBNAM 

JOBREN 

JOBRT 

JOBSA 

JOBTM 

JOBTTY 

JSYS 



316 



4 


13 


2 


28 


2 


32 


3 


9 


3 


12 


7 


l r 4 


3 


9 


7 


1,4 


3 


3 


3 


9 


APPEND 


1 



KFORK 



153 



LEVTAB 

LGOUT 

LHOSTN 
LHOSTN 

LITES 

LOG special capability 

LOGDES 



215 



5 


10 


1 


5 


2 


90 


3 


13 


4 


48 


1 


5,7,8 


3 


12 



1-8 



NAME 



JSYS SECTION PAGE 



LOGIN 

LPT: 

LS 



1 2 
4 2 

2 82 



Magtape I/O 

Methods of Data Transfer 

MOUNT 

MSFRK 

MTAn status bits 

MTAn: 

MTOPR 



— 


4 


5 


- 


2 


7 


122 


4 


45 


312 


10 


9 


- 


4 


5 


- 


4 


5 


77 


2 


69,81,83,84,88 



NCPGS 

NET: 

NETAWD 

NETBAL 

NETBTC 

NETBUF 

NETRDY 

NETS 

Network 

WIN 

Not implemented for DECtape files 

NOT IMPLEMENTED YET 
NOT IMPLEMENTED YET 
NOT IMPLEMENTED YET 



225 



3 


9 


2 


81,88 


3 


13 


3 


13 


3 


13 


3 


13 


3 


12 


3 


13 


2 


70,81,89 


8 


3 


2 


41 


1 
2 

4 


3 
22,35 
1,9,32 



1-9 



NAME 



JSYS 



NOT IMPLEMENTED YET 
NOT IMPLEMENTED YET 
NOT IMPLEMENTED YET 

NOUT 

Number Bases 



224 



SECTION 


PAGE 


5 
6 

10 


5 

4,17,19 

2 


8 


2 


INTRO 


7 



ODCNV 
ODTIM 
ODTNC 
OPENF 
OPERATOR special capability 



222 


8 


19 


220 


8 


11,12 


230 


8 


17 


21 


2 


22,81,83,84 


- 


2 


62,63,65 



Pager Traps 

Panic-Channels 

Parameter Block 

PBIN 

PBOUT 

PEEK 

PGSTAT 

PLT: 

PMAP 

Primary input 

Primary Input and Output Files 

Primary output 

Process pseudo-interrupt tables 



— 


5 


24 


- 


5 


5 


- 


10 


4 


73 


2 


46 


74 


2 


46 


311 


10 


10 


- 


3 


10 


- 


4 


7 


56 


2 


7,55 


- 


2 


46 


- 


2 


7 


- 


2 


46,47 


— 


5 


10 



1-10 



NAME 



JSYS 



SECTION PAGE 



PSB 

PSI 

PSOUT 

PTP: 

PTR: 



7 1 

2 88 

76 2 47 

4 6 

4 6 



QTIMES 



11 



RCM 

RDDIR 

RDSDP 

RELD 

Regular (non-sharable) files 

RELDC 

RELDP 

RESET 

RFACS 

RFBSZ 

RFC 

RFCOC 

RFMOD 

RFORK 

RFPOS 

RFPTR 



134 


5 


16 


32 


4 


47 


267 


4 


42 


71 


4 


8 


- 


7 


1 


263 


4 


37 


261 


4 


36 


147 


2 


27,84 


161 


6 


16 


45 


2 


44 


- 


2 


81,83, 88 


112 


4 


15,30 


107 


4 


13,25 


155 


6 


11 


111 


4 


29 


43 


2 


42 



1-11 



NAME 



JSYS 



SECTION PAGE 



RFRKH 

RFSTS 
RFSTS 

RIN 

RIR 

RIRCM 

RLJFN 

RMAP 

RNAMF 

ROUT 

RPACS 

RPCAP 

RTIW 

RUNTM 

RWM 

RWSET 



165 



18 



156 
156 


5 
6 


7 
12 


54 


2 


52 


144 


5 


12 


143 


5 


18 


23 


2 


26 


61 


2 


61 


35 


2 


36 


55 


2 


54 


57 


2 


59 


150 


6 


5 


173 


5 


22 


15 


3 


2 


135 


5 


17 


176 


5 


23 



SACTF 

Sample Program 

SAVE 

SBLKTM 

SCVEC 

SDSTS 

SETNM 

SEVEC 

SFACS 



62 


2 


62 


- 


2 


2 


202 


7 


5 


- 


3 


12 


301 


7 


8 


146 


4 


2, 11 


210 


3 


7 


204 


7 


7 


160 


6 


15 



1-12 



NAME 



JSYS 



SECTION PAGE 



SFBSZ 




46 


2 


44 


SFCOC 




113 


4 


15,30 


SFMOD 




110 


4 


13 r 26 


SFPTR 




27 


2 


7,31 


SFORK 




157 


6 


14 


SFRKV 




201 


7 


4 


Sharable SAVE 




- 


7 


1.3,6 


SIBE 




102 


4 


20 


SIN 




52 


2 


51,85 


SIR 




125 


5 


11 


SIRCM 




142 


5 


18 


SIZEF 




36 


2 


37 


SJPRI 




245 


10 


8 


SKPIR 




127 


5 


13 


SMON 




6 


1 


8 


SNAMES 




- 


3 


12 


SOBE 




103 


4 


20 


SOBF 




175 


4 


21 


Socket 




- 


2 


81 


Source/des tinat ion 


designators 


- 


INTRO 


4 


SOUT 




53 


2 


52,85 


SPACS 




60 


2 


60 


SPFLTS 




- 


3 


12 


SPLFK 




314 


6 


9 


SPJFN 




207 


2 


71 


SPRIW 




243 


10 


7 



1-13 



NAME 



JSYS 



SECTION PAGE 



SSAVE 

STABS 

STAD 

STDEV 

STDIR 

STI 

STIMES 

STIW 

STPAR 

STPDP 

STRDP 

STSDP 

STSTS 

STTYP 

SWAKES 

SWJFN 

SWTCH 

SYMTAB 

SYSGT 

SYSTAT 

System Tables 

SYSVER 



203 


7 


6 


106 


4 


24 


226 


3 


4 


120 


4 


44 


40 


2 


39 


114 


4 


31 


- 


3 


12 


174 


5 


9 f 21 


217 


4 


27 


265 


4 


40 


264 


4 


37 


266 


4 


41 


25 


2 


29 


302 


4 


28 


- 


3 


12 


47 


2 


45 


320 


3 


3 


- 


3 


12 


16 


3 


14 




3 


11 


- 


3 


9 




3 


10 



TELNET 

TENEX device designator 



88 
1 



1-14 



NAME 



JSYS 



SECTION PAGE 



TENEX SAVE format 

Terminal interrupt codes 

Terminating conditions 

TICKPS 

TIME 

Time zones 

TLINK 

TMON 

TTYJOB 



14 

216 
7 



7 


3,5 


5 


8 


5 


7 


3 


9 


3 


2 


8 


11 


4 


34 


1 


8 


3 


9 



Universal Fork Handle 
US RIO 



310 



INTRO 6 
10 10 



VERNUM 



WAIT 

Wakeup control 

WATDP 

WFORK 

WHEEL Capability 

WHEEL Special Capability 



306 


6 


22 


- 


4 


13,17 


270 


4 


42 


163 


6 


17 


- 


10 


7 




2 


8,62,63,65,66 


m. 


4 


48 



1-15 



JSYS MASTER INDEX 



1 September 197 3 



NAME 



LOGIN 

CRJOB 

LGOUT 

CACCT 

EFACT 

SMON 

TMON 



GETAB 

ERSTR 

GETER 

GJINF 

TIME 

RUNTM 

SYSGT 

GNJFN 



GTJFN 

OPENF 

CLOSF 

RLJFN 

GTSTS 

STSTS 

DELF 

SFPTR 



JFNS 

FFFFP 

RDDIR 

CPRTF 

CLZFF 

RNAMF 

SIZEF 

GACTF 



STDIR 
DIRST 
BKJFN 
RFPTR 
CNDIR 
RFBSZ 
SFBSZ 
SWJFN 



rsYS l 


\ SECTION PAGE 


1 




2 


2 




3 


3 




5 


4 




6 


5 




7 


6 




8 


7 




8 


10 


3 


14 


11 


3 


6 


12 


3 


7 


13 


3 


1 


14 


3 


2 


15 


3 


2 


16 


3 


14 


17 


2 


21 


20 


2 


15,81 


21 


2 


22,81,83,84 


22 


2 


24,84 


23 


2 


26 


24 


2 


28 


25 


2 


29 


26 


2 


29 


27 


2 


7,31 


30 


2 


32 


31 


2 


34 


32 


4 


47 


33 


2 


35 


34 


2 


25 


35 


2 


36 


36 


2 


37 


37 


2 


38 


40 


2 


39 


41 


2 


40 


42 


2 


41 


43 


2 


42 


44 


2 


43 


45 


2 


44 


46 


2 


44 


47 


2 


45 



1-16 



NAME 



BIN 

BOUT 

SIN 

SOUT 

RIN 

ROUT 

PMAP 

RPACS 



SPACS 

RMAP 

SACTF 

GTFDB 

CHFDB 

DUMPI 

DUMPO 

DELDF 



ASND 

RELD 

CSYNO 

PBIN 

PBOUT 

PSOUT 

MTOPR 



CFIBF 

CFIBF 

CFOBF 

SIBE 

SOBE 

DOBE 

GTABS 

STABS 

RFMOD 



SFMOD 

RFPOS 

RFCOC 

SFCOC 

STI 

DTACH 

ATACH 

DVCHR 



STDEV 

DEVST 

MOUNT 

DSMNT 

INIDR 

SIR 

EIR 

SKPIR 



5 # 


SECTION 


PAGE 


50 


2 


49,84 r 85 


51 


2 


50,84 f 85 


52 


2 


51,85 


53 


2 


52,85 


54 


2 


52 


55 


2 


54 


56 


2 


7,55 


57 


2 


59 


60 


2 


60 


61 


2 


61 


62 


2 


62 


63 


2 


64 


64 


2 


65 


65 


2 


67 


66 


2 


68 


67 


2 


66 


70 


4 


8 


71 


4 


8 


72 


4 


9 


73 


2 


46 


74 


2 


46 


76 


2 


47 


77 


2 


69,81,83,84,88 


100 


4 


19 


100 


5 


10 


101 


4 


19 


102 


4 


20 


103 


4 


20 


104 


4 


22 


105 


4 


23 


106 


4 


24 


107 


4 


13,25 


110 


4 


13,26 


111 


4 


29 


112 


4 


15,30 


113 


4 


15,30 


114 


4 


31 


115 


4 


31 


116 


4 


32 


117 


4 


43 


120 


4 


44 


121 


4 


44 


122 


4 


45 


123 


4 


46 


124 


4 


46 


125 


5 


11 


126 


5 


12 


127 


5 


13 



1-17 



NAME 



DIR 

AIC 

IIC 

DIC 

RCM 

RWM 

DEBRK 

ATI 



DTI 

CIS 

SIRCM 

RIRCM 

RIR 

GDSTS 

GDSTS 

SDSTS 

RESET 



RPCAP 
EPCAP 
CFORK 
KFORK 
FFORK 
RFORK 
RFSTS 
RFSTS 
SFORK 



SFACS 
RFACS 
HFORK 
WFORK 
GFRKH 
RFRKH 
GFRKS 
DISMS 



HALTF 

GTRPW 

GTRPI 

RTIW 

STIW 

SOBF 

RWSET 

GETNM 



GET 

SFRKV 

SAVE 

SSAVE 

SEVEC 

GEVEC 

GPJFN 

SPJFN 



# 


SECTION 


PAG 


130 


5 


14 


131 


5 


15 


132 


5 


15 


133 


5 


16 


134 


5 


16 


135 


5 


17 


136 


5 


4,19 


137 


5 


19 


140 


5 


20 


141 


5 


22 


142 


5 


18 


143 


5 


18 


144 


5 


12 


145 


2 


86 


145 


4 


2 r 10 


146 


4 


2,11 


147 


2 


27,84 


150 


6 


5 


151 


6 


5 


152 


6 


7 


153 


6 


8 


154 


6 


10 


155 


6 


11 


156 


5 


7 


156 


6 


12 


157 


6 


14 


160 


6 


15 


161 


6 


16 


162 


6 


17 


163 


6 


17 


164 


6 


18 


165 


6 


18 


166 


6 


19 


167 


6 


21 


170 


6 


21 


171 


5 


23 


172 


3 


8 


173 


5 


22 


174 


5 


9,21 


175 


4 


21 


176 


5 


23 


177 


3 


8 


200 


7 


3 


201 


7 


4 


202 


7 


5 


203 


7 


6 


204 


7 


7 


205 


7 


9 


206 


2 


71 


207 


2 


71 



1-18 



NAME JSYS 



SETNM 

FFUFP 

DIBE 

FDFRE 

GDSKC 

LITES 

TLINK 

STPAR 



ODTIM 

IDTIM 

ODCNV 

IDCNV 

NOUT 

NIN 

STAD 

GTAD 



ODTNC 

IDTNC 

FLIN 

FLOUT 

DFIN 

DFOUT 



CRDIR 
GTDIR 
DSKOP 
SPRIW 
DSKAS 
SJPRI 



ASNDP 
RELDP 
ASNDC 
RELDC 
STRDP 
STPDP 
STSDP 
RDSDP 



WATDP 
ATPTY 
CVSKT 
CVHST 
FLHST 



GCVEC 
SCVEC 
STTYP 
GTTYP 
BPT 



s # 


SECTION 


PAG 


210 


3 


7 


211 


2 


34 


212 


4 


22 


213 


4 


48 


214 


4 


47 


215 


4 


48 


216 


4 


34 


217 


4 


27 


220 


8 


11,12 


221 


8 


11,14 


222 


8 


19 


223 


8 


20 


224 


8 


2 


225 


8 


3 


226 


3 


4 


22? 


3 


4 


230 


8 


17 


231 


8 


18 


232 


8 


5 


233 


8 


7 


234 


8 


6 


235 


8 


8 


240 


10 


2 


241 


10 


5 


242 


10 


6 


243 


10 


7 


244 


10 


7 


245 


10 


8 


260 


4 


36 


261 


4 


36 


262 


4 


36 


263 


4 


37 


264 


4 


37 


265 


4 


40 


266 


4 


41 


267 


4 


42 


270 


4 


42 


274 


2 


70 


275 


2 


89 


276 


2 


90 


277 


2 


90 


300 


7 


9 


301 


7 


8 


302 


4 


28 


303 


4 


29 


304 


6 


21 



1-19 



NAME 



JSYS 



GTDAL 

WAIT 

HSYS 



USRIO 

PEEK 

MSFRK 

ESOUT 

SPLFK 

ADVIZ 

JOBTM 

DELNF 



s # 


SECTION 




305 


3 


8 


306 


6 


22 


307 


10 


9 


310 


10 


10 


311 


10 


10 


312 


10 


9 


313 


2 


48 


314 


6 


9 


315 


4 


35 


316 


3 


3 


317 


2 


30 



PAGE 



SWTCH 



320 



NOT IMPLEMENTED YET 

FACT file 

LOG special capability 



File Handles 

File References in TENEX 

Sample Program 

File Names 

File Access Protection 

End of File Pointer 

Methods of Data Transfer 

Primary Input and Output Files 

Input/output errors 

WHEEL Special Capability 

Indexable file handle 

File Group Descriptors 

NOT IMPLEMENTED YET 

JFN status word 

Not implemented for DECtape files 

Primary input 

Primary output 

OPERATOR special capability 

File descriptor block 

Network 

Socket 

NET: 

RFC 

FS 

FH 

LS 

CLS 

HOSt-Host 

INR/INS 

TELNET 

PS I 

LHOSTN 

ASCIZ 

Error numbers 
JOBDIR 



1 


3 


1 


5,6,7 


1 


5,7,8 


2 


1 


2 


1 


2 


2 


2 


3 


2 


5 


2 


7 


2 


7 


2 


7 


2 


8 


2 


8,62,63,65,66 


2 


18 


2 


18 


2 


22,35 


2 


28 


2 


41 


2 


46 


2 


46,47 


2 


62,63,65 


2 


63 


2 


70,81,89 


2 


81 


2 


81,88 
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JOBRT 

JOBTTY 

System Tables 

TTYJOB 

TICKPS 

NCPGS 

DEVCHR 

DEVNAM 

DEVUNT 

DSKERR 

DRMERR 

SYSVER 

VERNUM 

PGSTAT 

SYSTAT 

QTIMES 

HSTNAM 

LOGDES 

IMP 

JOBNAM 

IMPHRT 

DBUGSW 

ENTFLG 

SBLKTM 

STIMES 

SYMTAB 

SPFLTS 

SNAMES 

SWAKES 

NETRDY 

HOSTN 

IMPLT2 

IMPLTl 

LHOSTN 

NETAWD 

NETBAL 

NETBTC 

NETBUF 

NETS 

IMPLT4 

IMPLT3 



TENEX device designator 

NOT IMPLEMENTED YET 

LPT: 

Device dependent Status bits 

Magtape I/O 

MTAn status bits 

MTAn: 

PTP: 

PTR: 

CALCOMP 

PLT: 

JFN Mode Word 

Echo mode 

Data mode 

Wakeup control 

Control Character Output Control 

Character Set 1-2 1 
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Class 

Wheel Special Capability 



NOT IMPLEMENTED YET 

Channel usage 

Panic-Channels 

Forced termination 

Terminating conditions 

Dataset carrier off 

Terminal interrupt codes 

Deferred Terminal Interrupts 

LEVTAB 

CHNTAB 

Process pseudo-interrupt tables 

Interpretation of TRAP Word 

Pager Traps 



NOT IMPLEMENTED YET 
Assigned capabilities 
Fork Status word 



JOBREN 

JOBSA 

Entry vector 

Sharable SAVE 

PSB 

Regular (non-sharable) files 

10/50 save format 

TENEX SAVE format 



Extended Range Format 

Floating point conversion JSYS's 

Floating Output Format Control Word 

Free Format 

General Format Control 

Internal date and time 

Date and Time Conversion JSYS's 

Time zones 

Date and time input formats 



NOT IMPLEMENTED YET 
Parameter Block 
WHEEL Capability 



JSYS 
EX JSYS 
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Source/destination designators 

File designator 

Device designator 

Pork Handle 

Pork/File Handle 

Universal Fork Handle 
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Abbreviations 

Date and time Standards 
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